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DEFINITIONS/ABBREVIATIONS 


ACK 

CCITT 

CSMA/CD 

DA 

DIS 

DISC 

DMA 

DTE 

FCS 

HDLC 

IEEE 

ISO 

LAN 

LACS 

LCB 

LLC 

LSAP 

LSB 

MSB 

OS I 

PDU 

PRIVATE 

RCV 

REJ 


ACKnoledge 

International Telegram and Telephone 
Consultative Committee 

Carrier Sense Multiple Access/Collision Detection 
Destination Address. 

Draft International Standard. 

Disconnected Mode. 

Direct Memory Acess. 

Data Terminal Equipment 
Frame Check Sequence. 

High Level Data Link Control. 

Institue of Electrical and Electronic Engineers 
International Organization for Standardization 
Local Area Network. 

Local Area Controller Subsystem. 

Logical Control Block (DPS 6 Level 6 User) 

Logical Link Control Layer. 

Logical Link Layer Service Acess Point 
least Significant Bit. 

Most Significant Bit. 

Open System Interconnection. 

Protocol Data Unit. 

Catagory of memory known to the communication 
kernel. It consists of the bank of memory local 
to the 68000 processor on the LACS. 

LLC layer recieve process. 

REJect. 
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SA 

SAP 

SHARED 

SSAP 

TEST 

UA 

UI 

XID 

XMIT 


Source Address. 

Service Access Point. 

Catagory of memory known to the communication 
kernel. It consists of the bank of memory local 
to the Layers on the LACS. 

Source Service Access Point. 

TEST function on LLC Layer. 

Unnumbered Acknowledgment. 

Unnumbered Information. 

exchange IDentification. 

Transmit process. 
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1. INTRODUCTION AND OVERVIEW 


1.1 BACKGROUND 

The Logical Link Control Layer for LACS oftware and Hardware 
development is designed and implemented to meet IEEE 802.2 
standard. The logical link layer is the conceptual layer of 
control or processing logic existing in the hierachical structure 
of a station that is responsible for maintaining control of the 
data link. The logical link layer functions provide an interface 
between the station higher layer logic and the data link. These 
functions include address/control field interpretation, channel 
access and command PDU/response PDU generation, transmission and 
interpretation. 

The IEEE 802 standard identifies two distinct "classes" of LLC 
operation Currently, we support Class I which provides 
data-1ink-connectionless service only. (Class II provides 
data-link-connection-oriented service plus 

data-link-connectionless service, this will be support later). 

In the IEEE 802 model, the LLC sublayer is responsible for 
supporting logical access points called LSAPs. The sublayer 
accepts write primitives from the Network layer above and formats 
them into write primitives for the MAC sublayer below. Incoming 
data in the form of indicate primitives from the MAC sublayer are 
prepared for the Network layer. Addresses associated with each 
layer are either added or removed as is appropriate for the 
direction of data flow and the layer involved. 


Honeywell Infomation Systems 
Page - 5 - 



LOGICAL LINK CONTROL LAYER (IEEE 802.2, in LACS) Component Specification 


1.2 BASIC PURPOSE 


The service of the Logical Link Layer is the capabilities which it 
offers to a user in the next higher layer (or lower l-ayer) . In 
order to provide its services, LLC layer builts its functions on 
the services which it requires from the next lower layer (MAC 
layer). The LLC layer's primitive services are: 


REQUEST 

The request primitive is passed from the LLC layer’s 
user (it could be the higher layer: Level 6, or 
Network layer, or Transport layer, or could be the 
lower layer: MAC layer), to the LLC layer's sublayer 
to request that a service be initiated. 


INDICATION 

The indication primitive is passed from the LLC 
layer's sublayer to the LLC layer's user to indicate 
an event which is significant to the LLC layer's 
user. This event may be logically related to a remote 
servicerequest, or may be cause by an event internal 
to the LLC sublayer. 


CONFIRM 

The confirm primitive is passed from the LLC layer to 
the LLC layer's user to convey the results of one or 
more associated previous service request(s). This 
primitive may indicate either failure to comply or 
some level of compliance. It does not necessarily 
indicate any activity at the remote peer interface. 
IN THE CURRENT RELEASE, WE DO NOT USE THIS 
MECHANISM TO HANDLE THE LAYER INDICATION. 

The Logical service access points called LSAPs are managed by 
the LLC sublayer and the LLC sublayer management services. 
Communications take place between local LSAPs and their peer 
enities, remote LSAPs, in the form of protocol data units (PDU). 
The Network layer or layers above LLC will select and use LSAPs 
to route messages to and from Network (or SubNetwork, or 
Transport) service access points called NSAPs (or TSAP’s). 
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1.3 BASIC STRUCTURE 


The LLC Sublayer and the LLC Sublayer Management functions are 
provided by a set of 3 processes that run under the Bridge Kernel 
operating system. The 3 processes are a layer -management 
process (LM), a transmit process (XMT) and a receive process 
(RCV). Each process will have public access to tables that 
contain the state and status of the process itself as well as 
the various service access points (SAPs). 

The mailboxes for a LLC Layer instance interface with the 
megabus software, the MAC layer and System Management. A 
mailbox will be created for each interface as follows. 


Mailbox Names 

(For Layer Instance 0-3) 

Layer Management LM 
default mailbox 

LNMLME 

LLC_LM0 

LLC_LMl 

LLC_LM2 

LLC_LM3 

Default mailbox for the LM process. All 
System Management messages arrive here and 
alarm messages returned from the kernel are 
routed here. 

Default mailbox for 
Transmit process XMIT 

llc_txO 

llc_txl 

llc_tx2 

llc_tx3 

Layer Management messages from LLC LM to 
transmit process LLC XMIT arrive here. 

Default mailbox for 
Receive process RCV 

11c rxO 
llc_rxl 
llc_rx2 
llc_rx3 

Layer Management messages from LLC LM to 
receive process LLC RCV arrive here. 


Megabus mbx 

IODISP 

MEMDMA 

IOLD messages and returning DMA requests 
arrive here. 

MAC_Data mbx MAC_DATA.indication messages and returning 

MAC DATA.request messages arrive here. 
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1.4 BASIC OPERATION 


The Logical Link Control Layer in the IEEE 802 Local Area Network 
Protocol is common to the various medium access methods that are 
defined and supported by the IEEE 802 activity. 

The Logical Link Control Layer interface service to the Network 
(Transport) Layer provides various services that the LLC layer, 
plus underlying layers and sublayer, offer to the Network 
(Transport) layer, as viewed from the Network (Transport) layer. 
These services are defined so as to be independent of the form of 
the medium access methodology, and of the nature of the medium 
itself. 

In order to support the LACS, a software driver will be written 
for the DPS 6 to provide the interface to the different layers. In 
addition to this. System Management facilities will be provided in 
the DPS 6 and LACS to help control and administer the local LACS 
as well as the entire network. 
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The following diagrams illustrate the Logical Link Layer serves 
different configuration of Local Area Network Protocals 


LLC LAYER AT THE CURRENT RELEASE LAN CONFIGURATION 
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LLC LAYER AT THE NEXT RELEASE LAN CONFIGURATION 
(With Network, Transport layers) 
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Code for the LLC and LLC layer mamagement functions will be loaded 
with the rest of the LACS board code and begin operating when the 
process has been activated by System Management. Data exchanged 
with other processes such as MAC or megabus interface software, 
will take the form of messages delivered to process mailboxes via 
services provided by the Kernel. 


LLC Layer Instance Block Diagram 


(Megabus) 


(Default) 

Interface 

LLC LME 

Process 

LME 

(Megabus) 

(MAC DATA) 

(Default) 

Interface 

indication 

SM 


LLC Receive 

Process 


_(Megabus)_ 

(MAC DATA) 

(Default) 

Interface 

LLC Transmit 

Process 

SM 
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The Process for transmit is the following: 

1. recieve "xmit" LCB from level 6. 

2. Validate LCB. 

3. detect if data in LCB directly. If it is, go to step 5. 

4. If data is not in LCB, call DMA bring data buffer cross the 
MEGABUS interface from level 6. 

5. allocate llc_trans block. 

6. convert LCB data to transaction block. 

7. prepend the LLC header. 

8. send message LLC_PDU (llc_trans) th MAC layer for transmit. 

9. Set up all statiatic counters. 
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The Process for recieve is of the following: 

* ' J 

There are three cases, recieve LCB arrival, PDU arrival, and XID, 

TEST response. 

I. recieve LCB 

1. recieve "READ" LCB from level 6. 

2. validate LCB. 

3. If PDU queue has waiting PDU block, then convert each of the 
PDU block (in the queue structure order) to LCB data format, 
andsend each one (in order) back to level 6. Untill PDU in 
queue are sent out completely. Complete the READ LCB. 

4. If PDU queue is empty, allocate READ LCB transaction block to 
transfer the LCB data to READ transaction block. Hang up the 
transaction block at the READ LCB queue. (If the queue is 
already full, drop this transaction block return the memory 
allocated). 

5. set statistic counter. 

II. recieve PDU 

1. recieve PDU data block from MAC layer. / 

2. validate PDU. If illigal PDU, drop it. 

3. If PDU is valid, strip the LLC header. 

4. convert PDU block to llc_trans block. If there are outstanding 
read LCB in the LCB queue, send PDU llc_trans block to level 6. 

If read LCB queue is empty, hang the PDU transaction block in 
the PDU queue. If the queue is full, drop the PDU, and clean 
the PDU memory. 

5. update statistic counters. 

III. recieve XID/TEST: 

1. upon receipt of an XID command PDU from MAC prepare and send 
response XID PDU to requesting station. 

2. upon receipt of a TEST command PDU from MAC prepare and send 
response TEST PDU to requesting station. 


,4 \ 

'vy 
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2. LOGICAL LINK LAYER EXTERNAL SPECIFICATION 


2.1 OWNED DATA STRUCTURES 

Each process in the set that make up a LLC layer instance will 
have access to layer data structures via an Instance Common Area. 
Pointers to local and remote LSAP tables, the IOLD function 
directory, and mailbox IDs for the various interfaces will all be 
contained in the Instance Common Area. 

Layer Instance Common Area 
Data structure type LICA: 


Data Structure discription 


LLC Layer entry name 


Function directory mailbox ID array 

Recieve default mailbox 

Receive mailbox 

Receive MAC data indication 

Megabus DMA mailbox ID "MEMDMA" 

Megabus 10 Dipatcher ID "IODISP" 

Controller layer MGR ID "LNMLME" 

Transmit default mailbox 

Transmit mailbox 

LLC layer LME mailbox 

System MGR event mailbox 

MAC data request mailbox 

MAC activate mailbox 


fc_mbx_dir[16] 

rx_default 

rx_mbx 

rx_mac 

dmajmbx 

iodisp_mbx 

ct_lm_mbx 

tx default 

xmTt_mbx 

lme_mbx 

sm_event 

mac_data 

mac act mbx 


Number of local sap dir entries 
LSAP table pointer array 
Number of remote sap dir entries 
Index to next free entry in remote 
Remote LSAP table pointer array 


1_1s ap_dir_s z 
l_lsap_dir 
r_lsap_dir sz 
nxt_r_dir_Tndex 
r lsap dir 


Emergency event message pointer 


emer event 


PDUs to undefined remote LSAPs 


ctr und pdu 


Layer instance major state 

Layer instance substate 

Max PDU size for the layer instance 

Layer instance number 

Layer number 

Layer instance init step 


1ijmajorstate 

li_substate 

max_pdu_sz 

inst_numbr 

layer 

init step 
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Unknown error counter 

IOLDs counter for layer manager 

LCB to level 6 counter for LM 

LCB to lacs counter for receive 

IOLDs counter for receive 

LCB to level 6 counter for receive 

LCB to lacs counter for receive 

IOLDs counter for xmit 

LCB to level 6 counter for xmit 

LCB to lacs counter for xmit 

Buffer to level 6 counter 

Buffer to lacs counter 

Number of xmit PDU dropped 

Number of receive PDU dropped 


ctr_unk_err 

ctr_IOLDs_l 

ctr_LCB_16_l 

ctreLCB_lac_l . 

ctr_IOLDs_r 

ctr_LCB_16_r 

ctr_LCB_lac_r 

ctr_IOLDs_x 

c t r_LCB__l 6__x 

c tr_LCB_lac_x 

ctr_BUF_16 

ctr_BUF_lac 

ctr_PDUd_tx 

ctr PDUd rx 
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2.1.1 LLC Local SAP Components 


LSAPs are represented in the LLC layer by SAP componemt tables. 
The table is created when directed by system management and 
exsist until deleted by system management messages. SAP 
Component tables will contain the following entries. 

Data Structure discription _ LLC Layer entry name 


LSAP symbolic name 
class of LSAP 

LSAP type 

LSAP venue 

Major administrative state 

LSAP sub administrative state 

lsap_name[16] 
c lass 
type[4] 
venue 

majorstate 
substate 

MAC instance number 

Length of MAC address (bytes) 

LSAP address (8 bits) 

MAC address for this lsap (48 bits) 
IEEE 802.2 states 

IEEE 802.2 type 

Logical local LSAP address 

SAP indicator and flag word 

mac_inst 
mac_adr_lngth 
lsap_adr 
mac adr[6] 

180 2_s t 
type_vct 
log_adr 
sap_ind_f lag 

Pointer to event LCB 

Event indicator and flag word 

event_trans 
event_ind_flag 

Network layer mailbox for this sap 

net mbx 

Current number of active remote sap 
pointer to activate remote sap dir 

c u r_num_rmt s 
r_act_dir 

Max transmit bytes 

Max receive bytes 

Max rtransmit credit 

ma x_xmit_by t e s 
max_rcv_bytes 
max tx credit 
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Receive LCB queue counter 
Receive PDU queue counter 
Transmit LCB queue counter 
Transmit PDU queue counter 


rcvq_lcb_count 
rcvq_pdu_count 
xmitq_lcb_count 
xmitq pdu count 


Actual transmit credit 
Actual receive credit 
Max PDU size 


ac t_xmi t_c red it 
ac t_rc v_c red i t 
max pdsz 


First LCBI transaction in queue 
LCBI root back pointer 
Dummy LCB last forward in queue 
Dummy LCB last backward in queue 
First PDU message in queue 
PDU root back pointer 
Dummy PDU last forward in queue 
Dummy PDU last backward in queue 
First EVENT transaction in queue 
EVENT root back pointer 
Dummy EVENT last forward in queue 
Dummy EVENT last backward in queue 


lcb_fwd 

lcb_bwd 

lcb_end_f 

lcb_end_b 

pdu_fwd 

pdu_bwd 

pdu_end_f 

pdu_end_b 

evn_f 

evn_b 

evn_end_f 

evn end b 


Array if IEEE 802 group address 


grp addr[64] 


Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 
Number of 


data octets transmitted ctr_do_tx 

data octets received ctr_do_rx 

frames with unknown command ctr__uk_fr 
LCB transmitted ctr_LCB_tx 

LCB received ctr_LCB_rx 

receive connection IOLDs ctr_IOLDs_rc 

event IOLDs ctr_IOLDs_ev 

active IOLDs ctr_IOLDs_ac 

UI frames transmitted ctr_UI_tx 

UI frames received ctr_UI_rx 

XID commands transmitted ctr_XIDc_tx 

XID commands received ctr_XIDc_rx 

XID responses transmitted ctr_XIDr_tx 

XID responses received ctr_XIDr_rx 

TEST commands transmitted ctr_TESTc_tx 

TEST commands received ctr_TESTc__rx 

TEST responses transmitted ctr_TESTr_tx 

TEST responses received ctr_TESTr_rx 

transmitt PDU dropped ctr_PDUd_tx 

receive PDU dropped ctr PDUd rx 
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IEEE802 Private states(DSA) 
IN_USE 
ENABLED 
DISABLED 
LOCKED 
TEST 

SHUTDOWN 


2.1.2 IEEE 802 Connection Components 

Connection oriented service is not provided in 
implmentation. 
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2.1.3 LLC Layer LCBI Formats 

V. 


The portion of the LCB actually transferred across the megabus 
is all that is used by LACS board code. Equivalent 'C' code 
structures are used to locate and modify portions - of the LCB 
while the image is resident on the LACS board. The format for 
LACS resident LCB blocks, known as LCBIs, is given below in 'C' 
notation. Be aware that this structure represents only the 
portion of the L6 defined LCB that is actually transferred 
across the megabus. 

Data Structure discription _ LLC Layer entry name 


Interrupt control word 


cbicw 

Function specific function code 

cbfsf : 

Buffer indicators 


cbind 

Total Byte range 


cbtrg 

Number of buffer 


cbbct 

BUFFER DESCRIPTOR 


cbdes[3] 

Buffer address 


buf_adr 

Buffer indicator 


buf_ind 

Buffer range 


buf_rng 

Buffer residule range 


buf_rsr 

LCBI TYPES 


lcbi_type 

Generic LCBI block 


generic lcbi 

Reserved spaces 


cb_s [327" 

Activate local LCBI 


act_l lcbi 

Symbolic name 


cbsymTl6] 

Proposed read max credit 


cbprc 

Proposed read SDU size 


cbpms 

Reserved spaces 


cb_s[12] 

Maximum SDU size 


cbmss 

Ideal SDU size 


cbiss 

Max pending read count 


cbmpr 

Write credit count 


cbwcc 

Maximum number connections 


cbmcc 

Logical address - local sap 

selector 

cblsa 

Deactivate local LCBI 


da_l_lcbi 

Logical address - local sap 

selector 

cblsa 

Reserved spaces 


cb_s [30] 

Activate remote LCBI 


act_r_lcbi 

Logical address - local sap 

selector 

cblsa 

Symbolic name 


cbsym 

Reserved spaces 


cbrsv 

Reserved spaces 


cb s[18] 

Remote logical address 


cbTra 
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Read LCBI information 

read_lcbi 

Local lsap logical address 

cblsa 

Reserved spaces 

cb_s [21] 

Local actual buffer address 

SAP additional read credit 

cblbs 

Actual buffer size 

cbabs 

Remote sap indicator 

cblri 

Remote logical address 

cblra 

Write LCB information 

trans_lcbi 

Logical locap sap address 

cblsa 

Remote logical address 

cblra 

Class of service 

cbcls 

Reserved spaces 

cb_s [26] 

Write credit 

cbawc 

Event LCBI information 

event_lcbi 

Connect indicate event information 

cn_ind 

Function specification wd 

cb_s23 

Quality of service 

cbcls 

Expidited data option 

cbexd 

Return sap indicator 

cbrs i 

Logical remote address 

cblra 

Connection id 

cbc id 

Data arrival event information 

data_arr 

Reserved spaces 

cbs [6] 

Actual buffer size 

cbabs 

Additional write credit event 

add wc 

Reserved spaces 

cb_s[7]. 

Additional write credits 

cbawc 

SAP error event 

sap err' 

Reserved spaces 

cb_s [7] 

SAP error reason code 

cbrcd 

Controller status 

cbcts 

Indicator word 

cbf ss 

Completion word 

cbcbs 
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2.1.4 Layer Function Directory 


Entries in the Function Directory used by the LLC Layer Instance 
are limited to receive, transmit, activate, and event. 


2.1.5 Mesasge Formats 


According to the message MSG data structure definition of the 


Bridge Communication Kernel, the 
as follow: 

Data Structure Description 

Next message on circular list 
Last message on circular list 
Processid of sending process 
Buffer description 
Urgent or normal 
User message type 


message common data structure is 


Kernel entry names 

m_f wd 

m_bwd 

m_sender 

m_bufdes 

m_prio 

m_type 


2.1.6 MAC DATA request message format 


The following is a generic Medium Acess Control Layer data 
request mwssage format for different MAC layers. 


Data Structure Description 


MAC-LLC entry names 


Normal message header 
Frame control channel 
Pointer to desc build area 
Return mailbox id 
Return status field 
Class of service parameters 
ether type field or 802.3 length 
LAN destination address 


mh 

frame_ctl 
pkt_desc 
return_id 
status 
cl_of_srvc 
type_f Id 
mac DA 


,4 

( ' 
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2.2 EXTERNAL INTERFACES 


As mentioned above, all interfaces with other processes on the 
LACS board will be by mailbox messages. All of the messages 
seen by the LLC process have their formats defined by the 
respective process. Consult the MAC layer, the megabus 
interface software, an the system management services for the 
message formats. 

In the execution of a request by one of these layers, several 
steps involving exchanges of messages with other processes will 
take place. Once a message has been "mailed" to another process 
the context and state of the "transaction" is lost. Therefore 
some mechanism must be in place to retrieve the context and 
state when the next step is to be executed. The method used in 
this code consist of a "transaction block" message. 

The transaction block message is composed of a header area that 
is large enough to hold any of the messages that must be 
exchanged with other processes. After the header area, pointers 
to tables and values that are part of the transaction context 
become part of the transaction and are passed along with the 
message. 

Transaction blocks are created at two times, once when an IOLD 
is received and once when the MAC layer sends a data indicate 
message. 

Transaction blocks are used to send the following messages. 


LCBIO 
BUFIO 
CONFMSG 
L DATA msg 


DMA request to move LCBs across the megabus 
DMA requests to move buffers across the megabus 
MAC_DATA.confirm messages 
L DATA.request and .indication messages 


In addition, the transaction block carries pointers to the LCBI 
related to this transaction, the L6 memory address of the LCB, 
the length of the LCB, and the channel control word to be used 
when the LCB is returned to the L6. 
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The Logical Link layer transaction block data structure is listed 
at the following. At the top of the structure is a union of/ 
several message types used in the processing of a transaction tc>x 
reduce the decoding and table lookup that would otherwise 
required. 


Data Structure discription 


LLC Layer entry name 


Transaction server serv 

Transaction blk queue pointers trn_blk 

DMA requests for LCBIs lcbio 

DMA requests for buffers bufio 

MAC DATA request messages mdr 


Pointer to a MAC data indicate msg 
Data buffer descriptor pointer 
The length of LCBI 
The channel involved 
Pointer to the buffer descriptor 
Level 6 memory pointer to LCBI 
Pointer to the buffer descriptor 
Level 6 memory pointer to buffer des. 
Pointer ro the local LSAP table 
Pointer to the remote LSAP table 
Local logical address 
Remote logical address 


mac_ind 

data_bd 

lcbi_leng 

lcb_chan 

16 _mem_ptr 

16 mem_ptr 

bdT_blk 

16 _bdi_ptr 
l_lsap_table 
r_lsap_table 
l_log_addr 
r log addr 


2.3 INITIALIZATION REQUIREMENTS 


Tables that describe the adapter that is being supported by this 
LLC layer process and a SAP component for LLC Layer Management 
will have been created by the initialization code of the process 
when it is created by the layer management. 


2.4 TERMINATION REQUIREMENTS 

There are no termination requirements for the LLC layer since it 
will be active in one form or another as long as the LACS board 
is active. 


4 

\ 
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2.5 ENVIRONMENT 


All LLC layer functions will be coded in the ' C' language, 
compile to 68000 assembly language by the cc68 compiler, and run 
under the Bridge real time kernel. Macros and header.files from 
the Bridge communication development environment will be used 
where they can without alteration. The LLC layer will also use 
the header files from the megabus interface software, the MAC 
layer, and system management to define message formats and 
content. Refer to the respective header files for the details. 


2.6 TIMING AND SIZE REQUIREMENTS 


The code should be as efficient as prosible. 


2.7 ASSEMBLY AND LINKING 


All source code for the LLC layer will be under the version and 
release control of the SCCS (Source Code Control System) 
facilities provide by the UNIX development environment and the 
project source code administrator Assembler ad68 which is provided 
by the Bridge Communication development is used. Linking will be 
under the control of the master product Makefile used to combine 
all modules that constitute the product. Linker ld68 which is 
provided by the Bridge Communication development is used. Refer to 
UCOS UNIX MENU and the Bridge Communication Software Specification 
for the detailed description of these facilities. 


2.8 TESTING CONSIDERATIONS 


All product's sofeware functions are tested by the developer. 


2.9 DOCUMENTATION CONSIDERATIONS 


All LACS Logical Link Control Layer documentations will be written 
by follow the recommendations of The Honeywell software 
documentation guidelines. Also, all code design descriptions will 
be accompanied by a Procedural Design Language description. 


Honeywell Infomation Systems 
Page -24- 



LOGICAL LINK CONTROL LAYER (IEEE 802.2, in LACS) Component Specification 


2.10 OPERATING PROCEDURES 


The LLC layer must recieve an IOLDs request before any other 
request take place. The emergency event transaction block 
should always availible for catastrophic error .report event 
message in the case of kernel running out of memory. 
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2.11 ERROR MESSAGES 


Logical Link Control Layer errors can be divided into the 
following classes: 

* Catastrophic Errors 

* Unreportable Catastrophic Errors. 

* Refortable Catastrophic Errors. 

* Fatal Operart-ion Errors 

* Fatal Operation Error that must be reported to the 
initiator or the operation. 

* Fatal Operation errors that must be reported to the 
initiator of the operation and as an event to the 
System Management. 

* Non-Fatal Operation errors. 

* Recoverable Errors. 

* Protocol Errors. 

* DPS6 System Error. 


2.11.1 ERROR CONDITION DEFINITIONS 


Unreportable catastrophic errors are errors where the integrity of 
the LACS controller is corrupted sufficiently to warrant halting 
the LACS controller. Futhermore the controller cannot be trusted 
to event report the error. These are typically hardware errors 
such as parity error while executing instructions, LACS internal 
bus errors. 

Reportable catastrophic errors are errors where the integrity of 
the LACS system is corrupted sucfficiently to halt the LACS but it 
is possible to make an effort to report the error. These are 
typically caused by software errors where the LACS system is not 
set up correctly. 

Fatal operational errors are errors which cause the process to 
abort the particular operation that it is performing and require 
that the layer server deactivate a SAP or disconnect a connection. 

Non-fatal operation errors are errors which cause the process to 
abort the particular operation that it is performing. 

Recoverable errors are errors which are temporary in nature 
typically caused by a temporary lack of controller resoiurce. 

The protocol errors and DPS-6 system errors do not fall in the 
classes described above. 
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2.11.2 ERROR CONDITION HANDLING 

V 


For the unreportable catastrophic errors, the approach taken in 
handling such errors is to immediately halt all LACS processing in 
order to preserve the state of the LACS at the time of the errors 
occurence. The DPS6 detects a LACS fatal unreportable catastrophic 
error through the absence of any LACS response or as a result of 
exceeding the allowed limits for a 10 instruction. There is a 
possibility that the LACS will not support a dump of it’s memory 
due to the severity of a nonreportable catastrophic errors. 

If the errors are reportable catastrophic errors, any process 
detecting these errors must record the location and type of the 
error in a common area associated with the process and report it 
to the layer management process it associated with. An error event 
indication is sent to LACS system management. The LACS system 
management process will attempt to report to the SM layer in the 
DPS 6. In the event that the system management process failed to 
report it to the DPS6, it will request the controller to halt the 
LACS. The controller process will also save an indication of the 
type of error in a known system area and set up the controller to 
all I/O orders. 
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2.11.3 ERROR MESSAGE CODES 


All errors that detected by the LLC layer are handled at the 11c 
err routine. The Codes listed below included all detected error 
conditions. 


ERROR 

CODES(decimal) ERROR CONDITIONS 

LLC LAYER ERROR FLAGS 

-1 

No match on a search address or name 

NO MATCH 

-2 

For error but not exit, to calling 

ERR_RETURN 

20 

Bad function spec, function code 

BAD FSFC 

22 

Invalid function code 

INVALID FC 

24 

Bad layer instance state 

BAD LAYER STATE 

26 

Bad or unknown remote SAP 

BAD REMOTE SAP 

28 

Bad or unknown local SAP 

BAD LOCAL SAP 

30 

SAP already active 

SAP ACTIVE 

32 

SAP deactivated 

SAP DACTIVE 

34 

Multiple activate requests on SAP 

MULTIPLE ACT 

36 

Bad remote SAP state 

BAD R LSAP STATE 

38 

Bad local SAP state 

BAD L LSAP STATE 

40 

Create local LSAP error 

CR L LSAP ERR 

42 

Create remote LSAP error 

CR R LSAP ERR 

44 

SAP not available for services 

SAP NOT AVAILABLE 

46 

Bad DSAP in receive PDCJ 

BAD RCV DSAP 

48 

Bad SSAP in receive PDU 

BAD RCV SSAP 

50 

Bad DMA transfer of data buffer 

BAD BUFF TRAN 

52 

Bad DMA transfer of buffer descriptor 

BAD BDI TRAN 

54 

Bad transmit request desc. 

BAD XMIT REQ 

56 

Bad PDU size 

BAD PDU SIZE 

58 

LCB buffer size too small for PDU 

BUFF TOO SMALL 

60 

Bad DSAP state 

BAD DSAP STATE 

62 

PDU exceeds max PDU size 

PDU TOO BIG 

64 

Receive LCB, PDU queue full 

QUEUE FULL 

66 

Invalid transfer 

INV TRANSF 

68 

Return LCB error 

RT LCBI ERR 
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70 

Bad LCBI response - big err 

BAD LCBI RP 

72 

Incorrect venue value 

BAD VENUE 

74 

Data too long for data in LCB 

TOO LONG DLCB 

75 

LLC layer event code 

LLC EVENT . 

76 

DMA of a buffer failed 

DMA BUF FAIL 

77 

Send message fail 

SENDMSG ERR 

78 

Bad register mail box directory 

BAD REG MBXDIR 

79 

Mail box delete fail 

MBOX DL ERR 

80 

Bad receive PDU 

BAD RCV REQ 

81 

Mail box turn off fail 

MBOX OFF ERR 

82 

Invalid System Management request 

BAD SM REQ 

83 

Mail box turn on fail 

MBOX ON ERR 

84 

XID transaction error 

XID XMIT ERR 

85 

register mail box fail 

BAD REG MBOX 

86 

XID respound error 

XID RSPD ERR 

87 

Resolve mailbox fail 

BAD RESOLVE MBOX 

88 

Unknown message type 

UNKN MSG 

89 

Allocate no memory availible 

NO MEM ALO 

90 

Bad io message 

BAD IO MSG 

91 

Getbuf could not allocate 

NO MEM GET 

92 

Invalid SM return mailbox 

BAD SM MBOX 

93 

Genaric default error 

DEFAULT ERR 

94 

SM return mailbox full 

SM MBOX FU 

95 

MAC return mailbox full 

MAC MBOX FU 

96 

Invalid DMA mailbox 

BAD DMA MBOX 

97 . 

Invalid MAC mail box 

BAD MAC MBOX 

98 

DMA return mailbox full 

DMA MBOX FU 
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3. LOGICAL LINK LAYER INTERNAL SPECIFICATION 


3.1 OVERVIEW 


Code that implements the LLC functionality will have been 
linked with the Kernel, the System Management, and the 
Interface Software before being loaded on the LACS board. All 
required LLC processes will be activated via the actions of the 
system management process. When an adapter is to be supported, 
system management will create a LLC layer instance process 
for that adapter. The initialization code in the LLC layer 
process will in turn create the receive and transmit 
process passing a pointer to table structures for the instance. 


3.2 SUBCOMPONENT DESCRIPTION 


Each process supporting LLC layer activity for an instance, is a 
collection of procedures that will perform a series of steps 
required to execute the various commands supported. Requests 
for LLC actions are in the form of Kernel mailbox messages. 
Each message is a request to perform the next step in the 
sequence required by the type of request. 

Type 1 operations will conform to two operating states, active 
and inactive. In the inactive state, the LSAP has been defined 
but will not process any messages addressed to that address. To 
transition to the active state, the LSAP must have been defined 
via a create LSAP command from system management and then 
receive an activate LSAP command from the user via a LCB. The 
circumstances under which the states change are outlined in the 
following table. 


Type 1 Operations States 


Current 

Event 

Action 

Next 

State 



State 

INACTIVE STATE 

SAP ACTIVATION REQUEST 

REPORT STATUS 
ACTIVE 

ACTIVE STATE 


ACTIVE STATE 

RECEIVE_UI 

DATA_INDICATE 

ACTIVE_STATE 


DATA_REQUEST 

SEND_UI 

ACTIVE_STATE 


XID_REQUEST 

SEND_XID_C 

ACTIVE_STATE 


RECEIVE_XID_C 

SEND_XID_R 

ACTIVE_STATE 
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RECEIVE_XID_R 

TEST_REQUEST 

RECEIVE_TEST_C 

RECEIVE_TEST_R 

SAP_DEACTIVATE 

REQUEST 


XID__INDICATE 

SEND_TEST_C 

SEND_TEST_R 

TEST_INDICATE 

REPORT_STATUS 
SAP INACTIVE 


ACTIVE_STATE f 

\ 

ACTIVE_STATE 

ACTIVE_STATE 

ACTIVE_STATE 

INACTIVE 

STATE 


The terms used in the above table are defined below. 

INACTIVE_STATE The LSAP is defined but will not respond to incoming 

messages. User requests will be returned with an 
inactive status indicated, with an inactive status 
indicated. 


ACTIVE_STATE The LSAP is ready to process incoming messages, or 

user requests. 

SAP_ACTIVATION The activate request LCB from a user. 

REQUEST 


RECEIVE_UI An unnumbered information frame was received by the 

MAC layer and resulted in a message in the LLC layer 
mailbox. The message type is MAC_DATA.indication. v 

DATA_REQUEST An L_DATA.request message from a network layer or the 
~ megabus has been received. 


XID_REQUEST A send XID command was received from system 

management. 


RECEIVE XID C An XID command was received for this LSAP. 


RECEIVE_XID_R The XID command has returned as this message type. 

TEST_REQUEST A request to send a TEST message was received from 

system management. 

RECEIVE TEST C A TEST command was received for this LSAP. 


RECEIVE_TEST_R A TEST command response was received from the LSAP 

addressed in the TEST request. 

SAP_DEACTIVATION A request has been received from SM or the 
REQUEST user to deactivate the LSAP. 


\ 
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DATA_INDICATE Generate a L_ DATA.indication message from the MAC 

DATA.indicate received. 

SEND_UI Generate a MAC_ DATA.request message from the L 

DATA.request adding the local and remote SAP 
addresses. 

SEND_XID_C Create a XID command from the system management 

request and send it. 

SEND_XID_R When a XID command arrives from a remote LSAP, return 

the message as a XID response. 

XID_INDICATE When the XID response to a XID command returns, the 

system management message is returned as a XID 
INDICATE. 

SEND__TEST_C Create a TEST command from this system management 

request and send it to the LSAP addressed. 

SEND_TEST_R When a TEST command is received at this LSAP, the 

TEST response message is returned. 

TEST_INDICATE The LSAP component has received the TEST response 

from a remote SAP. An indication of this event is 
returned to System Mgmnt. 

REPORT_STATUS This is the response returned to System 

SAP INACTIVE Management when requested to deactivate an LSAP. 
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3.3 LOGICAL LINK CONTROL Layer Initialization 


Each instance of the code executes as three independent 
processes under the control and scheduling of the kernel. 
System Management will use the kernel procreate ser.vice call to 
initiate the LLC layer management process and pass the pointer 
to a layer instance table. There are two parts to each process, 
an initialization phase and a normal execution phase. During 
the initialization phase, each process will test the step number 
in the instance table to determine which elements are to be 
initialized. Each step will save the pointer to the instance 
table passed by system management for future use. Step 0 will 
cause layer management related initialization steps to take 
place including the allocation of a function table for mailbox 
IDs. After the LME mailbox ID is entered : in the proper place, 
the table is registered with IOLD software. The step count is 
incremented to 1, and the instance table pointer is passed in a 
receive process via a create call to the kernel services. This 
time receive initialization steps are performed. The instance 
table pointer is saved, receive mailboxes created and registered 
in the function table, and the step number incremented to 3. 

The transmit process is created passing the pointer to the 
instance table as a parameter. Again the instance table is 
saved for the transmit process to use in future events and 
transmit related initialization takes place. Mailboxes atf 
created and their IDs entered into the function table in ttk - 
transmit positions. 

Each process suspends execution at the end of initialization and 
waits for messages. The kernel will give the process control 
when the criteria for priority and messages waiting for the 
process have been met. 


4 
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3.4 Normal operations 


Two parameters are present when the process is restarted, a 
pointer to the message and the mailbox ID used by the kernel to 
determine process state. This process will accept e.ither of two 
messages from system management at the mailbox assigned when 
the process was created. The first to arrive will be a request 
to create a local LSAP. Table space will be allocated from 
PRIVATE memory large enough for the LSAP status. The pointer is 
then entered into the LSAP directory for this layer instance. 
The table will have entries for LSAP name, LSAP address, type, 
and the local MAC address to be used filled in. After setting 
the state of the LSAP to inactive, the message is returned to 
system Management with an indication of success or failure 
status. 

The next type of messsage is the create remote LSAP. This 
message will cause the process to allocate a remote LSAP table 
from PRIVATE memory and add it to the layer’s remote LSAP 
directory. The name, type, address, and remote MAC address will 
be filled in and the LSAP left in an inactive state. This 
message is also returned to system Management. 


3.4.1 Activate LSAPs 


When the activate LSAP message is received via LCBs, the named 
local LSAP is located in the layers LSAP directory. The MAC 
associated with this LSAP is determined and a registration 
message exchanged with the MAC layer. After saving the MAC 
layer mailbox ID, placing the LSAP in the active state, the 
number of 10 credits and logical address (for local and remote 
lsap, must be in the LSAP directories range) is returned in the 
LCB. The LSAP is now ready to process messages. 

A similar set of steps are performed for activate remote LSAP 
except for the registration with any MAC layer. The remote LSAP 
is now active and messages from this address will now be 
recognized. 

Until a local and a remote LSAP are both defined and placed in 
the active state, messages with these addresses will be ignored. 
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3.4.2 IOLD Messages / 

V v 


This is the first step in any request. The message indicates 
that a LCB block of a given length at a L6 address is to be 
transfered across the megabus. A message with the length and L6 
address is sent to DMA services. When it returns, the next step 
will be performed. 


3.4.3 Connectionless Event Indication 


A test is made for the existence of the LSAP specified in the 
request. If the LSAP is present, a test is made for the active 
state. If both tests indicate that a LSAP is present and 
active, the addressed LSAP tables are scanned for 
L_DATA.indicate messages. If one or more messages are waiting, 
the LCBI is completed and a request to transfer it back to the 
L6 is made to DMA services. When there are no messages waiting, 
the LCBI will be queued on the LSAP table to await the arrival 
of a message. 


3.4.4 Read Connectionless Data 


The same tests that are made for Connectionless Event Indicatick 
commands in 3.4.3, are made for Read Connectionless Data 
commands. If the LSAP is both present and active, the message 
waiting queue is checked. If there are messages waiting, the 
buffer is transferred across the megabus to the memory address 
found in the LCB for the length specified. The LCBI is marked 
completed and returned across the megabus also. When the 
message queue is empty, the LCBI is queued to await the arrival 
of a message. 


\_/ 
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3.4.5 Write Connectionless Data 


When a LSAP is both defined and active, as in 
cause the buffer to be transferred across the 
Write request is changed into a L_DATA.request 
sent to the LLC layer for transmission. When 
returned, the LCBI is completed and returned across 


3.7, Write will 
megabus. The 
transaction and 
the confirm is 
the megabus. 


3.5 Local Area Control Subsystem Code — Layer Management 


Code that will create the layer SAP lists, and make or delete 
entries in those lists will reside in the LACS Code Layer 
Management. Inquiries returning the physical address or the 
logical route number as is appropriate for the layer will also 
be supported by this code. Layer management consist of 
procedures that process the messages listed below. 


3.5.1 L_TEST.request 

This request will cause the SAP component to transmit a TEST 
frame with the buffer passed as the data field. The 
command-response bit will be set to command. 

THIS FUNCTION IS NOT IMPLEMENTED AT THIS VERSION YET> IT SHOULD BE 
IMPLEMENTED AT THE NEXT VERSION, AS PLANNED. 


3.5.2 L_TEST.indication 

TEST commands are processed at the SAP component since they do 
not require a logical link to be active. If the 
command-response bit indicates that this message is a response, 
a search will be made for the TEST.request command that will be 


waiting for completion, 
returned with the buffer. 

When 

found, 

the 

message 

will 

be 

When the command-response 

bit 

is set 

to 

command, 

and 

the 

optional information field 

is 

present. 

it 

will be 

returned 


without modification as a TEST response. The SAP address fields 
are exchanged, the command-response bit set to response, and the 
message queued to the transmit process. No states or modes are 
affected. 


3.5.3 XID.indication 


This request will cause LLC to issue a XID command and wait for 
the response to return from the addressed LSAP. When it 
arrives, the XID information field will be returned in the 
indicate. 
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3.5.4 SM DATA.reques t 


THIS FUNCTION IS NOT IMPLEMENTED AT THIS VERSION YET> IT SHOULD BE 
IMPLEMENTED AT THE NEXT VERSION, AS PLANNED. 


3.5.5 SM DATA.indicate 


THIS FUNCTION IS NOT IMPLEMENTED AT THIS VERSION YET> IT SHOULD BE 
IMPLEMENTED AT THE NEXT VERSION, AS PLANNED. 


3.5.6 LM SET VALUE.request 


This message is a request to set one of the values in the 
parameter set being maintained for a layer. The message will 
contain a return mailbox, a parameter identifier, a parameter 
value access control information, and an empty field for return 
status. 

When the message is returned as a LM_SET_VALUE.confirm, the 
status will be set to the results of the action. Resulting 

status may be success or failure for one of the following 
reasons: success, f ail_operation, f ail_parameter, fail_valuer ^ 

fail_access control. Access control will be allocated but ncL y 
used in this first release. 

THIS FUNCTION IS NOT IMPLEMENTED AT THIS VERSION YET> IT SHOULD BE 
IMPLEMENTED AT THE NEXT VERSION, AS PLANNED. 


3.5.7 LM GET VALUE.request 


This message is the request to read out the value of a parameter. 
The message will contain a return mailbox, a parameter 
identifier, access_ control_ information, a field for the 
returning parameter_value, and a field for return status. The 
return message, a LM_READ_VALUE. conf irm, will contain status and 
the value requested. 

THIS FUNCTION IS NOT IMPLEMENTED AT THIS VERSION YET> IT SHOULD BE 
IMPLEMENTED AT THE NEXT VERSION, AS PLANNED. 


3.5.8 LM ACTION.request 


This message will contain a return mailbox, an 
act ion_ identifier, an act ion_ value, access_control__ information^ ’ 

and a field for returning status. When the message returns as 7 
LM_ACTION.conf irm, the status and action_value will have been” 
set. The actions defined thus far include the following. 


3.5.9 LM_EVENT.indicate 
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3.7 FUTURE DEVELOPMENT AND MAINTENANCE 


Future development is expected to include the Transport and 
Network modules. Both will conform to OSI standards to insure 
compatabi1ity with other vendors in the domestic and 
international markets. The future of Honeywell product lines 
depends heavily on the adherence to these standards. These two 
layers are described in this text only to delineate the 
compatability issues. 


NEXT RELEASE IMPLEMENTATION ISSUES 

In the next release (Dec. 1986), some of the issues to implement 
in the Logical Link Control layer for the LACS communication 
software are listed as following: 

Implement generic LCBI data structure in order to coordinate 
with Network and Transport layers. 

Improve error checking algorithm, and error condition handling. 
Improve source code readibility 

Set up mail box message limitation to 16 or so. Detect the 
mailbox full situation, and status counter set up for message 
dropped. 

Transport, Network layer interfaces. 

Aging counter set up for PDU, LCB. Or using LIFO or FIFO 
mechanism to handle queue full condition. 

(currently, FIFO mechanism for PDU, and LCB queue is 
implemented) 

System management GET function support. 

System management UPDATE function support. 

Efficiency improvement at IOLDs, Transmit, Receive processes. 
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4. PROCEDURAL DESIGN f 

Design procedul is as the following: 

1. IEEE 802 standard review and implementation algorithms 
discussion. 

2. Data structure design. 

3. PDL presudo code implementation. 

4. C code implementation. 

5. Compiling, assembling, and linking debugging. 

6. LAN software testing debugging. 

7. Release. 

8. Support and efficience improving for the future version. 


/ 

\ 
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APPENDIX B 

The following standard BNF definitions describe the various 
system mamagement messages that can be received by the LLC 
Layer and the parameters involved. 


LAYER MANAGEMENT MESSAGE ::= MESSAGE HEADER, MESSAGE TYPE, 

MESSAGE INFORMATION 

MESSAGE HEADER ::= Kernel message header 
MESSAGE TYPE ::= REQUEST j CONFIRM | EVENT 
REQUEST ::= xx 
CONFIRM ::= xx 
EVENT ::= xx 

MESSAGE INFORMATION : := EXCHANGE ID, LAYER INTERNAL SELECTOR, 

ACCESS CONTROL, STATUS, OPERATION CODE, 
OPERATION INFORMATION POINTER 
EXCHANGE ID :A 16 bit integer 

LAYER INTERNAL SELECTOR ::= NAME, CLASS, TYPE, VENUE, STATE, 

SUBSTATE 

NAME ::= 8 ASCII characters 

CLASS ::= 05 

TYPE ::= 8022 

VENUE ::= LOCAL | IMAGE 

LOCAL ::= 1 

IMAGE ::= 2 

STATE ::= ANY | LOCKED | ENABLED | DISABLED | TEST | DOWN j 

SHUTDOWN | INUSE 

SUBSTATE ::= ANY | RESET | HALTED | LOADED | STARTED | OPERATIONAL 

ANY ::= 00 

LOCKED ::= 03 

ENABLED ::= 04 

DISABLED ::= 05 

TEST ::= 06 

DOWN :07 

SHUTDOWN 08 

INUSE ::= 09 

RESET ::= 01 

HALTED :02 

LOADED ::= 03 

STARTED 04 

OPERATIONAL ::= 05 

ACCESS CONTROL ::= 00 

STATUS ::= STATUS CODE, STATUS INFO 

STATUS CODE ::= SOURCE, STATUS ID 

SOURCE ::= 02 

STATUS ID ::= 8 bit integer 

STATUS INFO ::= STATUS LENGTH, STATUS INFO DATA 
STATUS LENGTH ::= 16 bit integer 
STATUS INFO DATA :xx 
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OPERATION CODE ::= LM_GET_VALUE J LM_SET_VALUE | LM_ACTION 
LM_GET_VALUE ::= 1 

LM_SET_VALUE ::= 2 ^ 

LM_ACTION ::= 4 

LM_GET_VALUE STATUS ID ::= STD STATUS 

LM_SET_VALUE STATUS ID ::= STD STATUS I BAD PARAMETER VALUE 
LM_ACTION STATUS ID : := STD STATUS | BAD STATE | BAD SUBSTATE | 

ILLEGAL STATE CHANGE 

STD STATUS : SUCCESS | NOT SUPPORTED | BAD ACTION OPERATOR | BAD 

LAYER INTERNAL SELECTOR 

SUCCESS ::= 00 

NOT SUPPORTED : := xx 

BAD ACTION OPERATOR : := xx 

BAD LAYER INTERNAL SELECTOR ::= XX 

BAD PARAMETER VALUE ::= xx 

BAD SUBSTATE ::= xx 

ILLEGAL STATE CHANGE ::= XX 

BAD LAYER INTERNAL SELECTOR XX 

OPERATION INFORMATION : := LM_GET_VALUE OP INFO | LM_SET_VALUE OP INFO | 

LM_ACTION OP INFO 

LM_GET_VALUE OP INFO ::= PARAMETER ID, CONFIRM INFORMATION POINTER 

LM_SET_VALUE OP INFO ::= PARAMETER ID, PARAMETER VALUE 

LM_ACTION OP INFO ::= ACTION OPERATION, STATE | SUBSTATE 

PARAMETER ID ::= xx 

CONFIRM INFORMATION POINTER ::= values | list of values 
PARAMETER VALUE POINTER ::= pointer to new value 

ACTION OPERATION ::= UPDATE STATE | CREATE j DELETE | LIST j TEST ACT 
UPDATE STATE ::= xx 
CREATE ::= XX 

DELETE ::= xx ! v 

LIST ::= xx 
TEST ACT ::= xx 
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Oiscription: 


Revision #: 1 

Date: 5/25/36 

3 y : M . L u 

Discription: 


Revision X : 
Date: 

3y: 

Discription: 


functions i Parameters: 

llc_lme (moxptr*mbx_name) 

MSG *mbxptr# 

M3ID mbx_name; 
lme_lco(mbxptr*lica_p> 

MSG *mbxptr; 

LICA *lica_o; 
sm_req(moxptr/lica_p) 

MSG *noxptr; 

LICA *lica_p; 
mu_reg_ax(mbxptr*lica_p> 

MSG *mbxptr; 

LICA *lica_p; * Pointer to the process variaoles * 
reg.normaKmbxptr^lica.p) 

MSG *mbxpt r; 

LICA *lica_p; * Pointer to the process variables * 
lm_set(mbxotr*lica_D) 


* Pointer to leb message 

* Pointer to lie layer inst. taole 

* Pointer to lie layer inst. table 

* Pointer to lie layer inst. t3ble 
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MSG *fflOxp:r; 

LICA *lica_p; * Pointer to the process variaoles * 
tm_cmpr_n.set(mbxotr*lic3_p) 

MSG *moxptr; 

LICA *liC3_p; * Pointer to t n e process variaoles * 

lm_get{mpxotr^lica_p) 

MS3 *mbxptr; 

LICA *lica.p; * Pointer to tne process variables *- 
lm.action(moxptr*lica.o) 


MSG *moxptr; 

LICA *lica.p; * Pointer to tne orocess variaoles * 
ageing.alarm(mcxptr*lica_p) 


MSG *mbxptr; 

LICA *1ica.p; * 
search_r_sao(remote, 
char *remote.addr 
R.LSAP.DIP *r.dir 
ushort *air_index 
LICA *lica.p; 
srch.nameClsap.name* 
cnar *lsap_name; 
R.LSAP.DIR *tsap_ 
ushort oir.sz; 
ushort *air_inoex 
LICA *lica_p; 
next.sap(r_cir.table 
R.LSAP.DIR *r_dir 
ushort dir.size; 
ushort *dir.index 


Pointer to the process variaoles * 
addr*r_dir.taDle*dir_index*lica.p) 

; * address of the remote LSAP to search * 

.taole; * Pointer to a remote LSAP directory table * 

* * Pointer to index into remote SA 3 directory 

* Pointer to the layer instance taole * 

lsap.dir*dir_sz*dir_irdex*iica_p) 

* Pointer to the LSAl 3 name for search * 
dir; * Pointer to a LSAP directory table * 

* Size of SAP directory * 

; * Pointer to index into SAP directory * 

* Pointer to the layer instance taole * 

*dir_size*dir.index) 

.table; * Pointer to a remote LSAP directory table * 

* Size of directory peing searched * 

* * Pointer to index into remote SAP directory * 


** * 



*/ 


/k k kk i 


* .........LLC Layer lanagement.... 

* This is the LLC Layer management that exist once for each 

* LLC Layer instance created. The combination of this process* 

* the recieve process and the transmit process constitutes one 

* lLC Layer instance. 

* 

* TITLE: LLC LAYER MANAGEMENT INITIALIZATION FUNCTION 

* FUNCTION: T3S 

*■ INPUT: 

* OUTPUT: 


* The following conventional * C' code header file is used 

* oy this process. See tne respective fites for definitions* 
^structures and macros. 
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* TITLE: 


wLC LAYEP MANAGEMENT FUNCTION 


FUNCTION: Receives all message directed to LlC L ^ mbox. It 

then determines the correct orocedure to call 
to service tne message. 


* INPUT: 

* 

* 


Pointer to message 
Mailoox name 


* OUTPUT: 

* 


* ......................LLC Layer Management..................... .. 

* This code is the operational layer management for each LlC layer 

* instance. Mailbox messages received will be oecoded by the switch 

* statement into a procedure call for each case listed below. The 

* pointer to the message and tne pointer to the LICA table will be 

* jassea on to each procedure as parameters. 

*/ 


/* pointer to the LICA taole */ 

/* Retrieve the Layer Instance Common Area pointer */ 

/* 00 CASE on message type */ 

/* CASE An I OLD request message */ 

/* increase counter */ 

/* Call common procedure to hanole tne I0L0 request */ 

/* CASE The confirm to DMA a LC9I to the LACS has returned */ 

/* increase counter */ 

/* Call the oroceaure which processes the LC9I */ 

/* CASE The confirm to DMA a LC3I to the Lb has returned */ 

/* increase counter */ 

/* Call the procedure which will clean up after completion of LC3I 

/* CASE SM request message has oeen received */ 

/* Call the procedure which processes system management requests */ 

/* CASE 10 Disp. and DMA mailoox io response message returned */ 

/* Call procedure to store mbx ids and 
initiate FC mox air. registr. */ 
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/* case serve to transport layer activate request */ 

/* call transport interface activate procedure */ 

/ * C A $ £ fC lax air. registration rasoonue message has -eturned * / 

/ * Call crocj.ure to clearuo a f t “ r recistriticn response returned * / 

/* CA5E MAC activate message returned form MAC layer mgr */ 

/* case CMU_R£G_83 + CNFR“_m$ 3 ); */ 

/ * Call procedure to cleanup after activation response returned */ 

/* OTHERWISE */ 

/* The message can not oe decoded into any that are exoected by this 

* process. 

* At tnis stage* 

* the space used by the message is returned to the kernel 

* until 3 method is designed to handle the proolem. 

iT 

* Also alarm messages should be aoaed 

it it it i 
*/ 


/* mfree(moxptr); */ 

f* return to the calling */ 
/* if £RR_ R£ TURN */ 


/* £NDCAS£ End of the message type decoding */ 
/* switcn */ 

/ * llc.lme */ 

/* Pointer to Icd message */ 

/* Pointer to lie layer inst. taole */ 

/* Error status */ 

/* Pointer to the transaction black */ 



/* A casting step */ 


/* 00 CASE on function specific function code in the LC3I */ 
/* CASS An event order ★/ 

/* CASE The activate LSAP order */ 

/* deactivate case */ 

/* OTHERWISE (invalid order for this channel) */ 

/* Set comDietion wora in the LCdl */ 


/* Request D*a services to transfer LCH */ 

/* This is ore of the difficult errors to handle */ 


/* if ERR RETURN */ 
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/* retjrn to tie calling */ 

/ * if cRR.RETURN * / 

/ * R e o o r t the presence of an invalid function caoe * / 
/* ENOCASE */ 

/ * switch * / 

/* llc.lme.lcb */ 


/ * 


* TITLE: 


SM REQUEST FOR LLC LM FUNCTION 


* 


* FUNCTION: 

* 

* 

* 

* 


Receives a SM request message and determines 
whether it is a valid request. The meesage is then 
forwarded to the function which can execute the 
request. 


* INPUT: 

* 

* 


Pointer to mailoox message 
Pointer to layer instance table 


* OUTPUT: 


* / 


/* Pointer to lie layer inst. taole */ 
/* Pointer to lie layer inst. table */ 


/* Pointer to the SM request */ 
/* Error code 


*/ 


/ * A casting step */ 

/ * 00 CASE on operation code in the request */ 

/* CASE A GET request */ 

/* CASE A SET request */ 
case SET: 

/* CASE A Compare and Set request */ 

/ * CASE An ACTION request */ 

/* OTHERWISE (invalid request) */ 

/★ if ERR.RE TURN */ 

/* cNDCASS */ 

/* switch */ 

/* Set message type to indicate a SM Confirm message */ 

/* Send the resoonse message to SM */ 
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/* return to the catling */ 
/ * if ERR_RETURN * / 

/* return to the calling * / 
/* if c3RETURN */ 

/* retjrn to the calling */ 
/* if £ 9R_RETURN */ 

/* llc_sme_req */ 


/ it It it It t 


it it it / 


/* The procedures in this section support tne layer management functions 

* for the tlC layer. 

* -LLC Layer Management ---*--- 

* The MAC sign-in message has returned 


*/ 


/* 


/* 



Pointer to the process variables */ 

/* This message is returning from the MAC sign-in process 

Pointer to the returning query message */ 

/* Save the mailoox 10 to send MAC_DAT A.request messages 

/* Release the message block to free memory again */ 

/* mu_req_ak */ 


*/ 


*/ 


/*- LLC Layer Management-------*/ 

/* The IOLO sign-in message nas returned */ 


/* Pointer to the process variaoles */ 


/* This message has oeen returned from IOLO sign-in and is counted 

* as oart of the transition to the 'ready state' for the instance. 

* Each message received increments the count oy one. 


*/ 


/* IF the registration was a success */ 

/* Record the return of one of the RES.NORMAL messages */ 

/* ENOIf */ 

/* LLC LME Initialization complete */ 

^ /* NEED TO FIND OUT IF EVENT SHOULD 3E ISSUED HERE OR IS IT OPTIONAL */ 


/* Release the message clock to free memory */ 
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/* reg_normal */ 


ft 


/ 

/* - 

/* L'I_ 3 £ T . request 

/ *r ************ 

/* Pointer to the process variaoles */ 


• * * / 


L L C Layer Management 


*/ 


*/ 


r ******i 


/* DO CASE on para meter_identifier */ 

/ * CASE each valio parameter */ 

/* IF the access.control_information is correct then */ 


/* IF this parameter may oe altered then */ 

/* IF the new parameter is in range for this item */ 

/* set the parameter to the new value */ 

/* select success status */ 

/* ELSE */ 

/* select fail_value status */ 

/* ENDIF */ 

/* ELSE */ 

/★ select fai l_operation status */ 

/* END IF */ 

/♦ELSE.*/ 

/ * select fail_access_control status */ 

/* ENDIF */ 

/* OTHERWISE */ 

/* select fail_parameter status */ 

/* ENDCASE */ 

/* return a LM_SET_V AlUE. confirmation message with selected status */ 
/* lm_set */ 


*****/ 
-★/ 

** ** * / 

/* Pointer to the orocess variaoles */ 

/* DO CASE on parameter^ dent if i er */ 

/* CASE each valio parameter */ 

/* IF the access_control„information is correct then */ 

/* IF this parameter may be altered then */ 

/* IF the new parameter is in range for this item */ 

/* IF the exoected_parameter_value is correct then */ 

/* set the new parameter value */ 

/* select success status */ 

/* ELSE */ 

/* select fail_expexted_value status */ 

/* ENDIF */ 

/* ELSE */ 

/* select fail_value status */ 


******** 


/*-LLC 

/* LM_C0MPARE_AND_SET.request */ 
/★*★******1 


Layer Management 
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/* ENDIF */ 

/* ELSE */ 

/* select fail_operation status */ 

/ * END I r */ 

/* ELSE */ 

/* select fail_access_control status */ 

/* EMDIf */ 

/* OTHERWISE * / 

/* select f<ai l.parameter status */ 

/* ENDCASE */ 

/ * l.fl_cmpr.n.set */ 


/ ***★*★★★★ it It It it it it it it i 


/* ------ LLC Layer Management 

/* L^otT. request message */ 


/ * Pointer to the process varisoles * / 



/* DO CASE on para meter_identifier */ 

/* CASE any valid parameter */ 

/* IF access.control.information is correct */ 

/* IF parameter is readaole */ 

/* read the parameter value */ 

/* select success status */ 

/* ELSE */ 

/* select fail.operation status */ 

/* EMDIF */ 

/* ELSE */ 

/* select fail_access_control status */ 

/* END IF */ 

/* OTHERWISE */ 

/* select fail.oarameter status */ 

/* ENDCASS */ 

/* return LM_SET.confirmation with selected status 
/* lm_get */ 


/ *1 


/ *------LLC Layer Management 

/* LY_<jcT. request message */ 


/ * Pointer to the process variaoles */ 



/* DO CASE on oarameter_identifier */ 

/* CASE any valid parameter */ 

/* IF access_control_information is correct */ 
/* IF parameter is readable */ 

/* read the parameter value */ 

/* select success status */ 

/* ELSE */ 

/* select fail_operation status */ 

/* END IF */ 

/* ELSE */ 
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/* select fail.access.control status */ 

/* END I F */ 

/* OTHERWISE */ 

/ * select fail.oarameter status *7 
/* ENDCASE */ 

/* return LM_D El. confirmation with selectee status */ 
/* lra_ael */ 


/*-----LLC Layer Management--—-- --— 

/* 

* TITLE: ACTION REQUEST PROCEDURE 

* 

* FUNCTION: Determines whether it is a valid action request 

* ana routes the request to the procedure required 

* to perform the operation. 

* 

* IN^UT: Pointer to message 

* Pointer to LlC common oata table 

* 


* OUTPUT: 

*/ 


/* 


lLC Layer Management 


*/ 


/* L1_ACTION.request message */ 


/* Pointer to the orocess variables */ 


/* SHOULD LLC ERR code EE INITIALIZED ???? */ 

/* Cast action request onto the message */ 

/* DO CASE on action_identifier *7 

/* CASE of a LIST ALL request */ 

/* IF request is to list all remote LSA? */ 

/* THEN */ 

/* Call list all remote LSAP procedure */ 

/* ELSE if request is to list all local LSAP */ 

/* Call list all local LSAP procedure */ 

/* OTHERWISE it must be a error */ 

/* ENDIF */ 

/* CASE of a UPDATE STATE reauest */ 

/* Call update LSAP state routine */ 

'oreaKf 

/* CASE of a CREATE LSAP request */ 

case CREATE: 

/* IF request is for a remote LSAP creation */ 

/* THEN */ 

/* Call create remote LSAP procedure */ 

/* ELSE I F request is to create a local LSAP */ 
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/* Call create Local LSAP orocedure * / 

/* OTHERWISE it must be a error */ 

/* ENDIF */ 

/* CASE of a DELETE ISA® reouest */ 

/* DEFAULT an unsuoported action identifier */ 

/* Cast action response on message */ 


/* Set status to indicate an unsupported action identifier */ 


/* ENDCASE */ 

> /* switch */ 

> /* Ime.action */ 


/*-—-—-LLC Layer Management-——- */ 

/* Message aging alarm message */ 



/* This message is the returning alarm request from setalarm. All l_pdu 
♦messages attached to 3ll LSAPs will be aged one time increment. Any message 

* found to oe over the age limit will be released pack to the buffer pool. 

* The assumption is that overaged messages are unexpected and 3 LC3 will 

* never oe issued. 


*/ 


/* IF this instance is in the ready state then */ 

/* FOR each IEEE302 defined LSAP that can exist */ 
/* Point to the LSAP table */ 


/* If the LSAP has been defined */ 

/* DC for each message on the waiting-for-LC9 queue */ 
/* Increment the aging counter */ 


/* IF the aging counter is STS the limit */ 

/* Remove the message from the queue */ 

/★ Release the buffer space to the oool * / 
/* update the queue counter */ 


/* Release the memory to the memory oool */ 



/* Notify 3W of the event */ 

/* ENDIF */ 

/* Roll thru the aueue to the next entry */ 
/* ENDDO */ 

/* ENDIF */ 

/* ENDFOR */ 

/* ENDIF */ 

/* Request tne next aging 3l3rm period */ 
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/ * *ir * t <r * 
/* — 
/ * 

♦ 


TITLE: 


- LLC Layer Management - 

SEARCH REMOTE LSAP ADDRESS PROCEDURE 


*/ 


* 

* 

* 

* 

* 

* 

* 

* 

<t 

* 

* 

* 

* 

* 


FUNCTION: 


INPUT: 


OUTPUT: 


This orocedurs searches the remote LSAP directory 
from a supplied 3Coress for a match tc a given 
address. It returns pointer to a value containing 
an index into the remote LSAP directory taole if it 
is already defined/ otherwise it will return 
a negative error value . 

Remote LSAP Address 

Pointer to remote LSAP taole directory 
Pointer to directory index value 


Error status 



/* 

******* NEED TO REVISIT THIS IN ORDER TO SUPPORT ******* 
******* ^ GENERIC LAYER FUNCTION ******* 

*/ 


/* Initialize flags/indexes/ and counts */ 

/* DO WHILE the remote directory index value is less than or equal to 
max number of entries in the directory */ 

/ * IF the directory index points to a valid entry (non null entry) */ 
/* THEN */ 

/* Fetch the pointer to the address in the remote LSAP taole */ 

/ * Set the status flag to indicate 

a match initially (null value) */ 

/* Initialize count to zero */ 


/ * Compare the two addresses an octet!byte) at a time to determine 
if there is a match */ 

/* DO WHILE the number of address octets checked 

is less or equal to 7 xxx Lu. 
ana the address octets match */ 

/* If the given address octet is 

eaual to the address octet in the remote 

LSAP taole */ 

/* THEN */ 


/* Increment the pointer to the address 

octet in the remote LSAP teaole */ 
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/ * 

Increment 

the 

numoer of octets 

checked 

*/ 

EL 

3 E there i 

s no 

aodress match 

*/ 


/ * 

Set status 

f La 

g to indicate a 

no match 

*/ 

/ * 

Increment 

the 

directory index 

value 

*/ 


/ * £t\DIF * / 

/* end do */ 

/* ELSE airectory entry Is not valid (null) */ 

/« Set status flag to inoic 3 te a no match */ 

/♦ Increment the directory index value */ 

/* ENDIF */ 

/* Set status flag to reflect match flag status */ 


/* cNDDO */ 
/* RETURN! */ 


r 


/* 

* TITLE: SEARCH LSA? NAME PROCEDURE 



♦ 

* 

* 


■* 

♦ 


* 

♦ 

* 

★ 


* 

* 

* 

* 

* 


FUNCTION: 


INPUT: 


OUTPUT: 


This procedure searches a local or remote LSAP airectory 
for a match to a given name. If a match is found r 
it returns pointer to a value containing 
an inaex into the LSAP airectory table . 

Otherwise it will return a negative error value . 

Pointer to LSAP Name 

Pointer to L $ A 3 taole airectory 

Site of LSAP directory 

®ointer to directory inaex value 

Pointer to layer instance taole 


Error status 


******* 


*/ 


/* 

******* 

******* 

******* 

*/ 


NEED TO REVISIT THIS IN ORDER TO SUPPORT ******* 
a GENERIC LAYER FUNCTION ******* 
ALSO make presentable ******* 



/* Initialize flags r inaexe s* and counts */ 

/* DO WHILE the remote directory index value is less than or equal to 

max number of entries in the directory */ 
/* IF the directory index points to a valid entry (non null entry) 


*/ 
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/* THEN */ 

/* Fetch the pointer to the n a m e in the LSAP taole * / 

/* Como a r e tne two addresses an octet(byte) at a time to determine 
if there is 3 «at:i * / 

/* Set the match flag to incicate a 

•natch initially (null value) */ 

/* Initialize count to zero */ 

/* 00 WHILE the number of address octets cneckea is 

less or eaual to 16 

and the address octets match */ 

/* If the given name octet is eaual to 
the name octet in the remote 

lSAP table */ 

/* THEN */ 

/* Increment the oointer to trie 

name in the remote L$AP taole */ 

/* Increment the number of octets checkea */ 

/* ELSE there is no address match */ 

/ * Set status flag to indicate a no match */ 

/* Increment the directory index value */ 

/* ENOIF */ 

/ * £ N D 3 0 */ 

/ * ELSE directory entry i rot valij (null) */ 

/ * Set match Flag to indicate a no match * / 

/* Increment tne directory incex value */ 

/* END IF */ 

/* Set the status fl3g to reflect the compare operation */ 

/* ENDDO */ 

/* PET URN */ 

> /* srch_name */ 


/ * ** ** **★★**! 


/* 


* TITLE: 


SEARCH FOR NEXT AVAI..A3LE DIRECTORY ENTRY PROCEDURE 


* FUNCTION: 
+ 

* 

*r 

* 

★ 

* 

* INPUT: 


* 

★ OUTPUT: 

* 

* 


This procedure searches the remote LSAP directory 
from a supplied address for 3 null entry 
address. It returns pointer to a value containing 
3n index into the remote LSAP directory table if it 
is already defined* otherwise it will return 
a negative error value . 

Pointer to LSAP taole directory 
LSAP table directory size 
Pointer to directory incex value 


Error status 
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HONEYWELL 

Local Area Network 

LOGICAL LINK CONTROL 

LAYER 

layer initialization nodule 


Copyright: Honeywell Information System 
All rights reserved. 

Cereate Date: 3/25/36 

3y: M. Lu 

Discription: 

Functions t* Parameters: 


* llc_lme_init (startuo.oaran) 

* STARTU?_PARAM *startuo_oara«i; * Pointer to startup parameter block * 

* llc_req_io_amaCreturn^robox*lica_p) 

* MSI D return_moox# 

* LICA *lica_p; 

* rcv_mbx_ids(mbxptr*lica_p) 

* MSG *mbxptr; 

* LICA *lica_p; * Pointer to the process variables * 

* reg_fcmbx_dir(lica..p) 

* LICA *lica_p» * Pointer to Layer Instance table * 

* create_l_lsap(mbxptr*lica..p) 

* MSG *mbxptr# * Pointer to create local L3AP message * 

* LICA *lica_o; * Pointer to the intance table * 

* create_r_lsap(mbxptr/lica_p) 

* MSG *mbxotr; * Pointer to create local LSA? message « 

* LICA *lica_p; * Pointer to the instance taole * 

* 

*** 

*** Revision #: 

*** bate: 

★ * ★ 3 y i 

*** Discriotion: 

k k k 

*** Revision #: 

*** Date: 

★ ★ k 3 y z 

*** Inscription: 
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* ....................LLC Layer Management........ 

* This is the LLC Layer management that exist once for each 

* LLC Layer instance created. The combination of this aroc?ss/ 

* the recieve process and the transmit process canstitutes one 

* LLC Layer instance. 

* 

* TITLE: LLC LAYS* MANAGEMENT INITIALIZATION FUNCTION 

* FUNCTION: T35 

* INPUT: 

* OUTPUT: 

* 

* The following conventional 'C coae header file is used 

* oy this orocess. See the respective files for oefinitions* 

* structures ana macros. 



* This is the initial entry point for The process. The 

* code is executed once as an initialization steo. All other 

* entries are at llc.lme. 


*/ 


/* Pointer to startup parameter block */ 

/* index variaole for array initialization */ 

/* clear olock size */ 

/* °riority of receive orocess */ 

/* a riority of transmit orocess */ 

/* Pointer to the layer instance common area */ 

/* Pointer to this layer instance receive process name */ 

/* Pointer to this layer instance xmit process name */ 

/* Return code from kernel calls */ 

/♦Pointer to I0L0 signin message*/ 

/* Pointer to the receive process PC3 */ 

/* Pointer to the transmit process PCS */ 

/* How do you make this a variable */ 

/* Start of LLC layer management initialization */ 

■ /* Allocate space for the LLC Layer Instance Common Area taole */ 

/* memory alocation error handl */ 

/* return to the calling */ 
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/* if ERR., RE TURN */ 

/ * record tne lica at reserved taole */ 

/ * Initialize all of layer instance taole to N Liu L W 

/« set layer instance table oointer */ 

/ * Clear it all */ 

/ * Save the pointer to tne LICA taole for this process * / 

/* Allocate space for the LLC local LEAP directory taole */ 

/* memory alocation error nandl */ 

/* return to the calling */ 

/* if cRR_RSTURN */ 

/* record the l_tsao_air pointer at reserved table */ 

f* Initialize all local Isao entries to NULL */ 

/* Allocate space for the LLC remote L3AP directory taole */ 

/* memory alocation error hancl */ 

/ * return to the calling */ 

/* if ERR_.RETURN */ 

/* record the r_l 3 ap_cir pointer at reserves taole */ 

/* Initialize all remote Isao entries to NULL */ 

/* Allocate space for the LLC emergency message to SM */ 

/* memory alocation error nanal */ 

/* return to the calling */ 

/* if' £PR_RETURN */ 

/* Initialize all LLC emergency message entries to NULL */ 

/ * Clear it all * / 

/* Create a second mailbox for LLC LME */ 

/* Add LLC Layer Management mailoox 10 to the function coae directory */ 

/* THIS IS A TEMPORARY PIECE FOR DEBUG */ 

/* Resolve mailbox for Controller LKE and Store in layer instance taole */ 

/* return to the calling */ 

/* if ERR_RE TURN *f 

/* Set layer to equal LLC (layer =2) */ 

/* Save the instance number passed by $M */ 

1* Fetch the priority of the receive process */ 

*/ 


/* Fetch the priority of the transmit process 
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/ * DO CASE on the layer instance numoer to determine process na 

/ * CASE This is layer instance zero * / 

/* Register tne well known mailbox name */ 

/ * return to the calling * / 

/* if ERR.RETURN */ 

/* Set layer instance process name for instance 0 */ 

/ * set pointer to receive process name */ 
t * set pointer to transmit process name */ 



/* CASE This is layer instance one */ 

/* Register the well known mailbox name */ 

/ * return to the calling */ 

/* if ERR.RETURN */ 

/ * Set layer instance process name for instance 1 * / 

/* set pointer to receive process name */ 

/* set pointer to transmit process name «/ 

/* CASE This is layer instance two * / 

/* Register the well known mailoox name */ 

/* return to tne calling */ 

/* if ERR.RETURN */ 

/* Set layer instance orocess name for instance 2 • */ 

/* set pointer to receive process name */ 

/* set pointer to transmit process name */ 

/* CASE This is layer instance three */ 

/* Register the well known mailbox name */ 

/ * return to the calling * / 

/* if ERR.RETURN */ 

/* Set layer instance orocess name for instance 3 */ 

/* set oointer to receive process name */ 

/ * set pointer to transmit orocess name */ 


/* DEFAULT - error 

/* if ERR.RETURN */ 


*/ 


/* END CASc 

/* switch */ 


*/ 



/* SHOULD THE RCV AND XWIT PROCESS M30XXES 3E STORED AWAY ??? 
/ * Create a receive process for this LLC instance * / 

/* Create a transmit process for this LLC instance */ 


*/ 


/* Request the D*!A and 10 moox ids 
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/* return to the calling */ 

/* if •£ RETURN */ 

/* Now it a matter of waiting for request mo x ias message to return * / 

/ * Kr ★ ★★*★*★»* itlt -kit "kit It'klitit'ikKifk-kltic-Xirit+ikirlr ***'****’★*■**★ kklciticXk'kit'kkitit'klr’k'icicifkkiciir/ 

/* Reauest Mailoox Ids for 10 Dispatcher and DMA procedure */ 

/ * 

TITLE: REQUEST MAIL30X IDs for 10 DISPATCHER and DMA PROCEDURE 


W 


* 

★ 

♦ 

* 

* 

* 

* 

★ 

* 

■* 

*/ 


FUNCTION: Issues a message to the Controller layer manager requesting 
the 10 Dispatcher and DMA mailoox ids. 

Input: Access to common system management data structures 

Return mailoox io 

Output: error Status 


/* 13 an: DMA moox id req. msg. */ 

/* clear block pointer */ 

/* block size */ 

/* clear block counter */ 

/* Allocate some space for an IOLD sign in message */ 

/* return to the calling */ 
/* if £R R_R E TU R N */ 

/* clean uo all mem moid_ptr */ 

/* Set the priority and clear the buffer descriptors */ 

f* Set the message type to register */ 

/* Set return mailoox ID */ 


t* Clear the ratjrn code */ 

/* Turn response mailbox on */ 

/* return to the calling */ 

/* if £RR_RETURN */ 

■/* Send massage to CT LM to fetch ID Dis. and D«!A */ 

f* return to the catling */ 

/* if ERR RE TURN */ 


/* Return 


/T^ 


/* reg_io„dma */ 
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/*--- LLC Layer Management--- 

/ * Tne 10 Dispatcher and DMA mailbox io request nas returned */ 

/ * 

* 


■ - * / 


nr 

* 

* 

★ 

if 

if 

* 


TITLE: 


DECEIVE MAILSOX IDs for IO DISPATCHER ana DMA PROCEDURE 


FUNCTION: Receives a message from the Controller layer manager 

returning the 10 Disoatcher and DMA mailbox ids. These 
mailoox ids are storeo away in the layer.instance taole 
and the registration of the the function code mailoox 
directory with the Controller LM is initiated. 

Input: Access to common system management data structures 

Output: Error Status 


*/ 


< 


/* Pointer to the process variables */ 

/« Pointer to tne returning message *f 
/* Error status */ 

/* The sign-in message has returnee fron I0LD interface software */ 

/* This message has been returned from IQLD sign-in */ 

/* return to the calling */ 

/* if ERR_RETURN */ 

/* return to the calling */ 

/* if ERR_R£TURN */ 

/* STORE away the iodisp and dma mailbox */ 

/* Release the message block to free memory */ 


/* Register with 10 Dispatcher tne function code mailoox directory 

/* return to the calling */ 

/* if ERR RETURN */ 


/* Now it a matter of waiting for I0LD registration to return */ 


*/ 


/* Return 


*/ 


/* rcv_mox_ids */ 


/ * 

* TITLE: REGISTER FUNCTION CODE MAILBOX DIRECTORY 



FUNCTION: 


Issues a registration message to the 10 Dispatcher 
which contains a pointer to the mailbox directory 
of a LLC layer instance. May be used oy other layer 
orotocols by modifying layer value Ci.e XPORT - set 
layer - A) and redirecting error processing. 
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★ 

* INPUT: 

* 

* 

★ 

* OUTPUT; 

* 

* 


Pointer to function code it. 3i Ibox directory 
Return mailbox io 
Value of layer instance 

Error code 

0 * success 




*/ 


/ N, 


/* Register -unction Code Mailoox Direc.cry routine »/ 

/* Pointer to Layer Instance table */ 

/ * Pointer to fc mbc x directory registration message */ 
/♦Error cooe * / 

/* clear block oointer */ 

/ * block size */ 

/* clear block counter */ 


/* Allocate some soace for an, 10 dispatcher sign in message */ 

/* return to the calling */ 

/* if ERR_RETURN */ 


/* clean up all mem moid_ptr */ 

/* Set the priority and clear the buffer descriptors */ 

/* Set the message type to register */ 

/* Set return mailbox ID to this layer manager instance mailbox ★/ 

/* Set pointer to function code mailbox directory */ 

/ * set channel for layer (shifted to left 3 bits) and layer instance */ 
/* Clear the return code */ 


/* Send message to 10 Dispatcher */ 

/* return to the calling */ 
/* if ERR.RETURN */ 

/* Release the message block to free memory */ 

/* Return with error code */ 

/* reg_fcmox^dir */ 


/* 


* ....LLC LAYER... 

* This is a collection of procedures that implement and support tne three 

* processes that are a LLC layer instance. They are constructed to take 

* aavantage of the *C* code oarameter passing by value and automatic 

* variables to implement the reentrant characteristics th3t will be 
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* reiuirec to suooort use oy several processes under the kernel. Some 

* oroceoures* such as the megaous support routines/ will be used oy all thre 

* orocesses in each of the four sosiole instances. The value oarameters 

+ and automatic variables will allow simultaneous use by tne three processes 

* within any one instance and the layer instance common areB tables' will 

* orovide the context for each individual instance. 


sir*** trk * * i 


: nr ★ * 


*/ 


/ * 
* 


TITLi: 


CR£AT£ LSCaL L S A? ?R3C20UR£ 


* 


* FUNCTION: 

* 

* 

* 

* 

* IN °UT: 

* 

* OUTPUT: 

* 


Receives a creat local L3AP request message * 
creates a LSAP table and initializes it tne values 
contained in the message. All statistical counters 
are reset to zero. No values are defaulted. 

Pointer to mailbox message 
Pointer to tayer instance table 



/* This procedure creates LSAP taoles and sets initial values. The procedur 

* must oe called with Create message pointer 

* and a pointer to the instance table that 

* tne LSAP is associated with. 


*/ 


/★ Pointer to create local LSAP message * / 

/ * Pointer to the intance table * / 

/ * pointer to create local Isao message * / 
/* Pointer to a LSAP table memory bloc* */ 

/* Number of the LSAP */ 

/* Index integer for arrays */ 

/* LLC error status */ 

/ * oloc k size */ 

/* clear blocks pointer */ 


/‘Cast on create Isap message */ 

/* Fetch Isap number from LLC address */ 

/* fix for all dir start at 1 */ 



/* IF Isap already existed 


*/ 


/* THEN there is an error 

/* return notice to the calling module* 


*/ 

badcreate 


request 


*/ 
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/* EN D I F 


»/ 


/ * Allocate some space far the L SA ? taole */ 

/ ★ IF space was availaole then * / 

/* Set 3ll initial values in the LSAP taole ★ / 

/* Clear the name ★/ 

/ * Allocate space for the activated remote LSAP directory and clear it 
/* Initialize all remote Isap entries to NULL */ 


/* !!! WHAT TO DO ABOJT GROUP ADDRESSES 

/★ 1!! WnAT TO DO ABOUT GROUP ADDRESSES 

/* Clear the grouo addresses 
/* Clear group addresses */ 


* / 


*/ 
★ / 


/* 

copy 

LSAP name from message */ 



/★ 

copy 

type 3022 from message */ 



/★ 

copy 

LSAf* address from 

message NEED 

TO 

REVISIT */ 

/★ 

ccoy 

LSAP address from 

message */ 



/* 


TO REVISIT - WHAT 

to do aoout 






adoress 

length 

/*lsap_ 

taole->lsao_adr++; 

* fix 

for start from 

/* 

set 

class to Li. */ 




/* 

set 

venue to local */ 



/ * 

set 

state */ 




/* 

set 

suostate */ 




/* 

set 

MAC mapoing ★/ 




/* 

set 

to maximum numoer 

of transmit 0 

ytes */ 

/* 

set 

to maximum numoer 

of receive bytes 

*/ 

/* 

set 

to type 1 */ 




/★ 

set 

to maximum P D U siz 

e in bytes 

*/ 


/★ 

set 

maximum receive credit 


*/ 

/* 

set 

maximum transmit credit 


★ / 

/★ 

Initialize all working 

queues/buffers 

and lists 




/* NE 

£0 

TO REVISIT 


*/ 


*/ 

*/ 


/* clear indicator flag ★ / 

/* End of the list +/ 

/★Top of the list */ 

/* End of tne list */ 

/* Reset all statistical counters */ 

/* NEED TO REVISIT */ 
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/* 

reel eve 

let) 

queue 

c oun ter 

*/ 

/ * 

r ecieve 

p 3U 

queue 

counter 

*/ 

/* 

recieve 

Ico 

queue 

c auntsr 

*/ 

/* 

recieve 

pau 

queue 

counter 

* / 


/* Data octets transmitted */ 

/* Data octets receives */ 

/* Unxnown commands */ 

/* numoer of LC2 transmitted */ 

/« numoer of LCS received */ 

/* receive connection ICLDs */ 

/* numoer of event IOLDs */ 

/* numoer of active ICLDs */ 

/* UI frames transmitted */ 

/* UI frames received */ 

/ * XI£> commands transmitted */ 

/* XID commands received */ 

/* XID resoonses transmitted */ 

/* XIO resoonses received */ 

/* TEST commands transmitted */ 

/* TEST commands received */ 

/* TEST responses transmitted */ 

/* TEST responses received */ 

/ * njinoer of xmit ocu droped */ 

/* numoer of rev pdu drooed */ 

/* Save the address of the LSAP table in the adapter table */ 

/* Set status */ 

/* set source to indicate its an LLC status */ 

/* zero out statusid to inoicate success */ 

/* set to 2 bytes */ 

/* set data to zero */ 

/* ELSE a Oad request */ 

/* Set status * / 

/* set source to indicate its an LLC status */ 

/* zero out statusid to indicate failure */ 

/* set to 2 pytes */ 

/* set data to zero */ 


/* ENDIF */ 

/* Set message type to indicate a SM Confirm message */ 

/* create_l_lsap */ 



FUNCTION: 

* 

* 



Receives a create remote L5A? request message » 
creates a remote LSA? taole and intitializes it the 
values contained in the message. All statistical 
cojnters are reset to zero. No values are defaulted. 
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* 

* 

* 

* 


*/ 


INPUT: 


G'JTPJT: 


Pointer to mailbox message 
Pointer to Layer instance table 


: it It it ik it it it it it it it n Hr ★ Hr * 5 



/* —----LLC Layer Management-*-*/ 

/* This procedure creates LSAP taoles ana sets initial values. The procedure 

* must oe called witn Create message pointer 

* ana a oointer to the instance taole that 

* the lSAP is associateo «ith. 


*/ 


/* Pointer to create local L3A? message *t 
/* Pointer to the instance table */ 

/* pointer to create local Isap message */ 

/* Pointer to a LSAP table memory block */ 

/* Number of tne LSAP */ 

/*.Index integer for arrays * / 

/* Index into remote SAP directory */ 

/* clear block pointer */ f 

/* block sire * / 

/ * LLC error status * / 

/* Cast on create remote Isa? message *7 

/* Call routine to search remote SAP directory for remote address */ 
/*return(CR_R_LSAP_£RR);*/ 

/* return oad status */ 

/* Call routine to search remote SAP directory for next available entry *7 

/* return to the calling * / 

/* if ERR.RETURN */ 

/* Allocate some space for the remote LSAP table */ 

/* IF no memory available for the remote LSAP taole */ 

/* THEN there is an error */ 

/* return to the calling */ 

/* if ERR RETURN */ 


/* ENDIF */ 

/* Set pointer to remote LSAP into next directory entry */ 
/♦increment index */ 

/* Initialize the remote LSAP taole ♦/ 

/* !!! WHAT TO DO A30UT REMOTE GROUP ADDRESSES ??? */ 

/* Clear group addresses */ 


w 
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/* 

coo/ 

t_ 3 A P 

name from message */ 



/* 

cop/ 

type 

SJ22 from message */ 



/* 

Copy 

Ls ao 

a adress len a tn into remote 

Isap t30le 

*/ 

/* 

copy 

LEAP 

address from message NEED 

TO REVISIT 

address 

/* 

set 

class 

to LL */ 



/* 

set 

venue 

to remote */ 



/* 

set 

state 

*/ 




/* set substate */ 

/* set to type 1 */ 

/* initialize log. adar. */ 

/* clear inaicator flag */ 

/* clear current number of act. */ 


/* Reset all statistical counters 

/* NEED TO REVISIT 

/* Data octets transmitted *7 
/* Data octets received */ 

/* Jn<nown commands */ 

/* JI frames transmitted */ 

/* UI frames received */ 

/* XID commands transmitted */ 

/* XID commanas received */ 

/* XID responses transmitted */ 

/* XID responses received */ 

/* TEST commands transmitted */ 

/* TEST commands received */ 

/* TEST responses transmitted */ 

/* TEST resoonses received */ 


/* 

Set 

status 


*/ 

/ * 

set 

sourc e to inaic at e 

its an 

LLC status 

/* 

zero 

out statusid to indicate 

success */ 

/* 

set 

to 2 bytes */ 



/★ 

set 

data to zero */ 




/* 

create remote Isap 

*/ 



length 


*/ 

*/ 
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HONEY WELL 

Local Area Network 


LOGICAL LINK CONTROL 
LAYER 
receive module 


Copyright: Honeywell Information System 
All rights reservea. 


Cereate Date: 1/25/86 

3y: 0. Oshaughn 

Discription: 


Revision *: 1 

Date:- 3/25/3o 

3y: A. Lu 

Discription: 


Revisi on #: 
Date: 

3y: 

Discription: 


Functions £ Parameters: 

llc_rx_inir (lica_p) 

LICA *lica_p; * Pointer to the layer instance common area * 
llc_rx (mbxptr*mpx_name) 

MSG *mbxptr; 

M6ID mbx_name; 

rcv_lcbi_to„lac(mbxptr*lica.p) 

MSS *moxotr; 

LICA *lica_p; * Pointer to the process variables * 
rcv_auf_to_lo(.mbxptr/lica_p) 

MSG *maxptr; 

LICA *lica_p; 
roac_i no ( mbxpt r.rlica_p> 

MSG *moxotr; 

LICA *lica.p; * Pointer to the process variables * 
validate_pdu(indmsgrllc_frames*r_log_addr^lica_p) 

DATA_IND_MSG *indmsg; * Pointer to the data indicate message 
LLC_F8MS *ltc_frames; * Pointer to incoming frames * 
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u_long *r_lo 3 _aaor; * Painter to 
LICA *lica_p» * Pointer to the 
send_buf_to_l6(llc_trans*lica_p) 
LLC_TRAN3 *llc_trans* * Pointer 
LICA *lic3_o; * Pointer to the 
aginj_alarm(moxptr*lica_p) 

MS i *moxotr* 

LICA *lica_p; * pointer to the 


re,note LSA? logical soar jss 
orocess variables * 

to the LLC transaction block 
process variables * 


orocess variables * 


it ft it 
it ft nr * * tr * i 


*/ 



/* 

* ....................LLC Receive Initialization.................... 

* This code initializes a receive process for a LLC Layer instance. 

* 


★ 

* 

* 

* 



* 

* 




TITLE: 

FUNCTION: 


INPUT: 


LLC RECEIVE INITIALIZATION PROCEDURE 

Initialize the Receive process oy storing 
the pointer to the layer instance common table 
in the receive process PCS. This procedure 
also create the mailboxes required for transmit 
ooeration and stores their id in the .function 
code mailbox directory 

Po-inter to Layer Instance common table 


* OUTPUT: 

★ 


* 


ft ft * it it i 


«/ 


/ it it it i 


/* Tne following conventional *C* coae heaaer file is used 

* oy this process. See the respective files for definitions* 

* structures ana macros. 


** ** ****** ' 


*/ 


/* START */ 

f* Save the pointer to the LICA taole for this instance */ 
/* NEED TO REVISIT ★/ 



/* Create a mailbox for receive functions* save default for alarms */ 
/* need limit to 1o or so* and error condition detecting handling */ 

/* Add LLC Receive mailoox ID to the function directory */ 


/* Create the mailoox for MAC_DATA.indication messages */ 
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/* NEED TO ALLOCATE AN EMERGENCY MSSSASc */ 

/* WHY DO WE NEED THIS */ 

/* Declare step 2 initialization completed */ 

/* END */ 


> /* llc_rx_init */ 


/ ★ ★ Hr hm 


r * Hr *★*★*★! 


/* 

* ... LLC Receive 3 roc ess .................it. 

* This is the operational receive process code for each LLC 

* layer instance, Mailpox messages received will oe decoded oy 

* the switch statement into procedure calls for the cases listed 

* oelow. Each call will pass a pointer to the message and the 

* pointer to tne LICA taPle as parameters. 


* 


Hr 

« 

* 

* 

* 

* 

* 

* 


TITLE: 

FUNCTION: 


IN 3 UT: 


LLC RECEIVE PROCEDURE 

Receives all messages directed to the LLC receive 
process for a layer instance. It then determines 
the correct procedure to call to process the request. 

pointer to message 

Mailoox name -- what for ? 


* OUTPUT: 

Hr 


* ..........LLC Receive Process ................... 

* This is the operational receive process code for each LLC 

* layer instance. Mailoox messages receiveed will oe decoded cy 

* the switch statement into procedure calls for the cases listec 

* oelow. Each call will pass a pointer to the message and the 

* oointer to the LICA taole as parameters. 


*/ 

/« Retrieve the Layer Instance Common Area pointer */ 


/* DO CASE on message type */ 

/* CASE DATA.indicate message from MAC */ 

/* Call procedure to receive a PDU from tne MAC layer */ 

/* SHOULD 3E RECEIVING AND CHECKING AN ERROR CODE HERE */ 


/* CASE An IOLD request message */ 

/* increase lOLDs counter for statistics */ 

/* Call common routine to transfer LC3I to LACS from IOLD msg */ 
/* SHOULD BE RECEIVING AND CHECKING AN ERROR CODE HERE */ 

/* CASS The request to DMA a LC3I to the LACS has returned */ 

/* Call procedure to interpret new LC3I */ 

/* increase LC3 to lacs counter for statistics */ 

/* SHOULD 9c RECEIVING AND CHECKING AN ERROR CODE HERE */ 
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( 

/* CASE The request to 0■*A a suffer oescriptor to the LACS has returned * / 
/ * increase puffer to lacs counter ‘or statistics */ 

/* Call routine to feten data buffer from L6 */ 

/* SHOULD 9= RECEIVING AND CHECKING AN ERROR CODE HERE •/ 

f* CASE The request to DMA a cuffer to tne u o has returned * / 

/* increase ouffer to 18 counter for statistics */ 

/* Call routine to request lebi be moved to L6 */ 

/* SHOULD 9£ RECEIVING AND CHECKING AN ERROR CODE HERE */ 

/* CASE The request to DMA a LCSI to the Lo has returned */ 

/* Call procedure to terminate LCSI and free all memory */ 

/* increase LCS to 16 counter for statistics */ 

/* SHOULD St oe making sure all memory returnee: */ 

/* SHOULD 3E RECEIVING AND CHECKING AN ERROR CODE HERE */ 


/* 



OTHERWISE */ 

/ ir **★**★*★ dr 


ir 


* The message can not be decoded into any that are expected by this 

* process. 

* At this stage* the soace used 

* by the message is returned to the kernel 

* until a methoa is designed to hanale the proolem. 


*/ 


/* set up unknoen error counter */ 
/* sena event message to the sme */ 


/* ENDCASE End of the message type decoding */ 
> /* lie rx */ 




/* ---- Megabus Interface —- 

/* The request to DMA a LCSI from the L6 to the LACS has returned 
/ * 

* TITLE: INTERPRET RECEIVE LCS RE DUE STS PROCEDURE 


*/ 


*/ 


* FUNCTION: 

It 

* 

★ 

* 

* 

* 

★ 

* 

★ 


Receives all DMA confirm messages due to the comoletion 
of a transfer of a LCSI to tne LACS memory. This 
routine determines if an additional transfer of a 
buffer descriptor is required and sends a message to 
the DMA software if it is neccesary. If a ouffer 
descriptor is not associated with the LC3 then this 
procedure will determine whether this is an event LCS 
or connectionless read request and call the appropriate 
procedure. 



INPUT: 


Pointer to message 

pointer to the layer instance taole 


* OUTPUT: 
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*/ 


/* 

* 


* 


* * * * * * tt ★ Hr ★ ★ ****** 1 


r ★ * fc* ir * : 


Tnis Tiessag? has oeen returned from DMA services. Tne following 
cooe w i 11 check the results of the 
transfer request and aeternine if it was 
successful. 


*/ 


/ * Local Isao index (equivalent to logocal aadress) 


*/ 


/* Cast on a transacation block structure */ 


/ * IF the request was successful * / 

/* THEN 

/* DO CASE on tne function coae in the LC 31 


*/ 


*/ 


/* CASE of an event LC3 */ 

/* EVENTS ARE NOT SERVICED UNTIL LATER */ 

/* CASE of a Connectionless reaa request */ 

/ * fetch local sap index * / 

/* IF the LSAP numoer is valid and the 

LSAP is ACTIVE (INUSc state) */ 


/* Set the local Isao table oointer into transaction block */ 


/* 

/ * 
* 

★ 

* 

* 


Set the local Isap logical 
transaction block */ 


address into 


When the ouffer pointer is in the LC3I* a search of the 
'waiting odu ' queue is made. If one is found* tne LC8I 
will be completed and returned* otherwise the LC3I will 
be added to the 'waiting LC3I' queue. 


*/ 


/* If the pdu waiting queue is empty */ 

/* check bound limit */ 

/* over the oound limit* drop the request */ 


/* Set LC3I function specific 

status to queue full */ 

/* set the read credit count for 

led user flow control */ 

/* Indicate LC 31 completion in the status */ 

/* Call common procedure to return LCdl */ 

> /* if */ 

/* else go ahe3a to queue up the request */ 

/* uodate the queue counter */ 

/* Add the transaction blk to the end of the 


/.: 
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c 

waiting List */ 

> /*else*/ 

/* ELSE (There are pau's waiting) */ 

/* Fetch first transaction oik containing the 
data indicate */ 

/ * Set the LCBI actual size from the waiting 
trans.oln. * / 

/* suotract three for LLC header */ 



/* IF LC3 buffer is large enough to contain the *0U */ 

/ * Need to subtract tne lie address header * / 

f * THEN send it back to the Lo */ 

/* Remove the first message from the 
waiting queue */ 

/* delete it from queue */ 

/* update the oueue counter */ 

/* Strip off LLC header from 

3 DU ana set buffer desc into trans-blk */ 

/* EXTRA STRIP OFF HEADER GET OUT BY *. LU 2/19/36 

/* Copy all pertinent info from 
/* L6 memory pointer */ 

/* Suffer Descriptor pointer */ 

/* Lo Buffer Descriptor pointer */ 

/* LC3I size */ 

/* channel stuff */ 

/* Return the buffer to the Lo */ 

/* Free memory of transaction block 
containing the LCBI */ 

> /* if */ 

/* ELSE Return LC3 with status * / 

/* Set LCBI function specific 
status to ouffer too small */ 

/* set the read credit count for 
Ico user flow control */ 

/* Indicate LCBI completion in the status */ 

/* Call common orocedure to return LCBI */ 

/* END IF */ 

/* END IF */ 



/* ELSE Dad LSAP ★/ 

/* Update LCBI to reflect bad local LSAP */ 

/* set the read credit count for leb user flow control */ 
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/* Indicate LC3I completion in the status */ 
/ * Return L C a I tc L6 
/ * £N01 F */ 


/■* OTHERWISE 33 1 function coo? */ 

/* Upoate LCiI to reflect oao function code */ 

/* set the read credit count for leb user flow control */ 
/* Indicate LC 31 completion in the status */ 

/* Return iCil to Li * / 

/* ENOCASE */ 

•LSc */ 

/* Set invalid status in the LC3I */ 

/* Update LC 31 to reflect oad function code */ 

/* Set status in HW error word ?????? */ 

/* set tne reaa credit count for leb user flow control */ 

/* Indicate LC3I completion in the status *t 

/* Try to send it oacic anyway */ 

ENDIF */ 

/* rcv.Icoi_to_lac */ 


/*-—--—--- MegaPus Interface-- 

/* The request to DMA a ouffer to the L6 has returned */ 


* This message is returned by DMA services when it completes the 

* transfer of a Puffer from the LACS board to the L6 as part of a read 

* transaction. This step will set the status in the LC5I ana request DMA 

* services to return tne LCB to the L6. 


/* IF Buffer transfered without any proolems */ 

/* then */ 

/* set the read credit count for leb user flow control */ 

/ * set remote logical address */ 

/* Indicate LC3I completion in tne status */ 

/* Return the LCdl to lo memory */ 

> /* if NULL */ 

/* ELSE */ 

/* Set status in LC3I accordingly 

/* Set status in HW error word ?????? */ 

/* set the read credit count for leb user flow control */ 

/* Indicate LC3I completion in the status */ 

/* ALL MEMORY WILL BE FREED AT COMOPLETI3N CF LC3I TRANSFER 
/* Return the LC3I to L6 memory */ 

> /* else */ 

/* ENDIF */ 

/* rcv_buf_to_16 */ 


LLC LAYER XID RESPONSE PROCEDURE 





3 


Seo 

( 

* 

* 

* 

it 

it 

it 

it 

It 

* 

* 
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call: llc_xid(indmsg/'lica_o) 

FUNCTION: 

Jhen recieve a XID recaest from the LAN 
lie layer will set uo resoonse message 
and send oacx to me XID request source. 

DESCRIPTION: 


*1* ir Hr It it ' 


• / 


/* Point to the Duffer */ 

/* Call procedure to validate the PDU request for tnis SAP */ 
/» IF it is a valid PDU */ 

/* Fetch the local LSAP table 

ignore grouo addresses for now */ 

/* swap the lie adoress */ 

/* cast to data request message */ 

/* updating xid xid counter */ 

/* count out address for xia message */ 

/ * out in xid response information */ 

/* stander info */ 



> 


/* put Isac name*/ 

/ * get lsap name * / 

/ * set message tyce * / 

/* set the oricrity */ 

/* swap the mac address */ 

> /* for */ 

/* outin own mac address*/ 

/*strcpy(rindm3g->layer.mac.source_addr.octetxl_lsap_tbl”>m3C_adr) 
/♦for (index = 0; index < l_lsap_tbl~>mac_adr_lngth; index**) 

> * for */ 

/* send to mac for tranfmit out */ 

/* free the message * / 

/* update message aroopec counter */ 

/* free tne message */ 

> /* else if M 3 X f u 11 * / 

> /* if lIcerr */ 

/* Drop the incoming pau/ the LSAP is not aefined */ 

/* update pud drop counter */ 

/* Free tne MAC message */ 

> /*else */ 

/* end tlc_xid */ 



LLC LAYER TEST REQUEST PROCEDURE 
call: llc_test(indmsg^lica_p) 

FUNCTION: 

When recieve a TEST request from the LAN 


*/ 
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lie layer will set up resconsa message 
ana sena esc* to tne TEST request source. 





DESCRIPTION: 


★*★*****1 
*/ 




r«Hr'*******Hr'** - *i 


r * * * * * * 


/* Point to the ouffer */ 

I* Call proceaure to validate the PD’J request for this SAP */ 

/* IF it is a valid PDU * / 

/* Fetcn the local L 3 A p table 

ignore group addresses for now */ 

/* swap the lie address */ 

/* updating test counter */ 

/* cast to data request message */ 

/* set message type */ 

/* set the priority */ 

/* swac the mac acaress */ 

/ * outin own mac address */ 

/*strcpy(rindmsg“>layer.mac.source_acdr.octetrl_lsac_tbl“>mac_adr);*/ 
/*for (index = 5; index < l_lsap_tbl->mac - adr_lngth; index**) 

/* send to mac for tranfmit out */ 

/* free tne message */ 

/* update message dropoed counter */ 

/* free the message */ 

> /* else if M3Xfull */ 

> /* if Llcerr */ 

else /* bad test odu */ 

/* Drop the incoming pdu* the L3AP is not defined */ 

/* update pud drop counter */ 

/* Free the MAC message */ 

> /* end lie test */ 


/ t 


**★*★**★*★ 1 




/* 

/* 

* 

* 

* 

* 

* 

* 

* 

* 


TITLE: 

FUNCTION: 


--LLC SAP Component----*/ 

validate received pcu procedure 

Validates a odu received from the MAC data 
inoicate mailbox. It determines if local and 
remote LSAFs have been defined for the layer 
instance and whether they are in the proper st3te. 
In addition the PDU size is checked against the 
maximum PDU size for this SAP. The remote Isao 
logical address is returned as well as the error 
status. 


* 

* 

* 

* 

* 

* 


INPUT: 


OUTPUT: 


Pointer to MAC data indicate message 
Pointer to LLC PDU 

Pointer to Layer Instance common table 

Pointer to Remote logical address 
Error status 
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r ★ ★ i 


/* 

/* 

/* 


/* 

/* 

/* 

/* 


/* 
/ * 
/* 


/* 

/* 


/* 


/ * 
/ * 
/* 


/* 

/* 

/* 


MAC_OATA.inaicate message »/ 

Clear an error flag */ 

Validate the logical address of tne remote ana local SAPs */ 

IF the local log. SAP adcr. (same as the OSAP) 
is greater than the local LSA® air. size */ 

/* Report a failure */ 

/* Set error code */ 

END IF */ 

Fetch the local L3AP taole 

ignore grouc addresses for now */ 

Validate that the local SAP exists */ 

IF the local LSAP does not exist * f 

/ * Set the state of the L 3 A ? and Layer Instance accordingly * / 
/ * Set L C 31 status words */ 

/* Report a LSAP failure */ 

/* Set error code */ 


ENDIF */ 

Validate the state of the layer instance *f 

IF the Layer instance is not in the I MUSE state * / 

/* Set the state of the L3AP ana tayer Instance accordingly */ 
/* Set LC3I status words */ 

/* Reoort a failure */ 

/* Set error code */ 

Validate the state of the local LSAP */ 

13 THERE A PROBLEM HERE IF THIS CODE IS EXECUTED EVEN THOUGH 
SAP IS NON-EXISTENT 

access undefined memory 

- pus error */ 

IF the major state of the LSAP is not INUSE * / 

/* Set the state pf the LSAP ano Layer Instance accordingly */ 
/* Set LCBI status words */ 

/ * ReDort a LSAP failure * / 

/* Set error code */ 

END IF */ 


Validate that the LSAP limits are not exceeded 


*/ 

*/ 

Instance accordingly 


IF the ?0U size exceeds the maximum PDU size 
/* Update statistical counters for LSAP and Layer 
/* Set LC3I status words */ 

/* Report a PDU failure *1 
/* Set error code */ 

END IF */ 

Validate the Remote LSAP */ 

Fetch the full remote LSAP address (tic ♦ mac) 

/* Fetch the remote LSAP taole * ignore group addresses for 
/* If the SSAP (remote SAP) has been not activated 
and local LSAP permits dynamic aodition to Activate directory 
/* THEN */ 

/* Add the remote to activated list */ 

/* Allocate memory for a remote LSAP taole */ 

/* Call procedure to search for next available LSAP entry */ 


*/ 

now */ 


*/ 


*/ 
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/* ELSE IF remote SAp nas not been activates */ 

/* Update statistical counters for 

LSAP ana Layer Instance accordingly */ 
/* Set LC3I status words */ 

/ * Peoort a 6ad remote $ A 3 failure * / 

/ * Set error code */ 

/* £NO If */ 

/* Set remote logical address to activate directory index 
> /* end llcerr == NULL */ 

> /* validate pdu */ 


* 


* LLC LAYER MANESEP DEACTIVATE FUNCTION 


* 

* This function will clean up all leb queue llc.trans 

* blocks/ clean up all pou queue llc_trans blocks. 

* set uo locked state/ ana post back all Icos 




/* get the l_sao_taole otr */ 

/* validate Isap taole */ 

/* set up layer NULL ***L3C:< state */ 

> / * end if */ 

/* return not valid led error */ 

/* completed with error*/ 

/* return the bad lea */ 

/* get out here */ 

> /* eIse */ . 

/* pull the local l_lsao_table address */ 

/* get the l_sap_t3Dle ptr */ 

/* delete from the leb queue */ 

/* kernel macro function foir queue */ 

/* get the on just take of the queue */ 

> /* if */ 

/* loop to clean up Ico queue trans oik */ 

/* for level o information/ Ico return */ 

/* level o completion bit set uo/ and err status set 
/* post back lebi */ 

/* delete from the leb queue */ 

/* kernel macro function foir queue */ 

/* get the on just take of the queue */ 

> /* while */ 


/* 

get the 

original trans */ 






/* 

keep track the oau 

droped 

*/ 




/* 

get the next pdu trans at 

the 

queue 

*/ 


/* 

dump tne trans blk 

*/ 





/ * 

get the next one to 

check 

ou t 

*/ 


> 

/* 

if */ 





/ * 

clean the oau queue */ 






/* 

keep track the pdu 

droped 

*/ 




/* 

get the next pdu trans at 

the 

queue 

*/ 


/* 

dump the trans blk 

*/ 





/* 

get the next one to 

check 

out 

*/ 
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( 

} /* while*/ 

/•* qet the original trans */ 

/* for clean the r_lsap table */ 

/ * looo to clean when r _ t s a p table not e m o t y * / 

/* NULL the r_lS3D table pointers */ 

/ * counter */ 

> /* while */ 

/* seno event message to system management 

/* 

send event message to system management mocule * 

* / 

/* return event lebi for completed oeactive */ 

/ * the last Icoi need to set up and send oack */ 

/* set up for level o completion pit ana err status */ 
/* post oacK Icoi */ 

> /* llc_lme_ca */ 


/*t***ilr*t*i 

/* ---LLC Layer 

/ * Message aging alarm message */ 

/ 


Management 


*/ 

/ 



/* 


* This message is the returning alarm request from setalarm. All l.pdu 

* messages attached to all 

* L 3 A P s w.ill be aged one time increment. Any message 

* round to be over the age limit will be released bacx to the buffer oool. 

* The assumption is that overaged messages are unexpected ' and a LC3 will 

* never be issued. 


*/ 

/* If this instance is in the ready state then */ 

/* FOR each let 3332 a a fined LSAP that can exist */ 

/* Point to the <-SAP table */ 

/* If the LSAP has been defined */ 

/* DO for each message on the waiting-pau Queue */ 
/* Increment the aging counter */ 

/* IF the aging counter is 6TE the limit */ 

/ * Remove tne message from the queue * / 

/* update the queue counter */ 

/* Release the memory to the memory oool */ 
/* Notify SiM of the event */ 

/w ENDIF */ 

/* Roll thru the queue to the next entry */ 

/* ENDOO */ 

/* ENDIF */ 

/* 2NDF0R */ 

/* ENDIF */ 

/* Request the next aging alarm oerioa */ 
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★ ★ ★ 


if if ie 
★ ★ ★ 
if if A r 
★ ★ * 
★ ★ * 

★ Hr ie 

★ ★ ★ 
★ * * 
Hr nr Hr 
if it if 
if If if 
Hr* * 
Hr Hr Hr 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 

★ Hr ★ 

★ ★ nr 

★ Hr ★ 

★ ★ ★ 
★ ★ ★ 
★ 

★ 

★ 

★ 

★ 

★ 

★ 

★ 

★ 

★ 

«r 

★ 

★ 

★ 

★ 

★ 

★ 

★ 

★ 

★ 

★ 

★ 

★ ★ ★ 
★ ★ * 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
Hr. ★ ★ 


HD.NEYwtLL 


Local Area Network 

LOGICAL L I N < CONTROL 
LAYER 
transmit moaule 


Cooyright: Honeywell Information System 
All rights reservec. 

Cereate Date: 1/25/80 

3y: 0. Oshaughn 

Discretion: 

Functions 4 Parameters: 


llc_tx_init (lica.p) 

LICA *lica_pj * Pointer to the layer instance common area * 
llc_tx (mbxptr^mpx.name) 

M S3 *moxptrF 
M5ID mbx.name; 

xmit_lcoi_to_lac(mbxotrrlica_p) 

MSG *mpxptrF 

LICA *lica_p; * Pointer to the Drocess variaoles * 
mac_conf_err(moxptr*lica_p) 

MSG *moxotr; 
i_IC A *1 i ca_p» 

xmit_buf_to..lac(moxptr*lic3_p) 

MSG *moxpt r» 

LICA *lica.p; 

validate_aata_req(llc_trans*lica_p> 

LLC_TRAN3 *llc_trans; 

LICA *lica_p; 

iss_mac_dreq(llc_trans^ l ica_p) 

LLC_TRANS *llc_trans; * Pointer to transaction olock for LLC PDU * 
LICA *lica_p; * Pointer to the instance table * 


Revision ,9: 1 

Date: 3/25/3o 

By: M« Lj 

Discription: 
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c 

*** Revision 4 : 

* * * '5 ate: 

*** 3y: 

»** 3iscription: 



*/ 


/ * 

* ................. ...LLC Layer M ana^e in ent.................... 

* This is the LLC Transmit Process that exists once for each 

* LLC Layer instance created. The combination of this orocess/ 

* the recieve process and the layer management process constitutes 

* one <_LC Layer instance. 

*/ 

/ * 

* TITLE: LLC TRANSMIT INITIALIZATION PROCEDURE 


* 

★ 

★ 



FUNCTION: 


Initialize the Transmit orocess by storing 
the oointer to the layer instance common taole 
in the transmit process PC3. This procedure 
also create the mailooxes required for transmit 
operation and stores their id in tne function 
code mailbox oirectory> 


* INPUT: Pointer to Layer Instance common table 

* OUTPUT: 

* 

.LLC Transmit Initialization.............. 


* This code initializes a transmit orocess for a LLC Layer instance. 


*/ 


* The following conventional *C' code heaaer file is used 

* oy this process. See the respective files for definitions^ 

* structures and macros. 


*/ 



/* 
/* 
/* 
/* 
/* 
/ * 
/ * 
/* 
/* 
/ * 


START */ 

Save the pointer to the LICA taole for this instance */ 

NEED TO REVISIT */ 

Create mailbox for transmit operations */ 

save default for alarms */ 

Add LLC Transmit mailoox 10 to the function directory */ 

NEED TO ALLOCATE MEMORY FOR AN EMERGENCY MESSAGE */ 

■WHY DO WE NEED THIS */ 

Declare step 3 initialization completed */ 

END */ 
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> /* llc.tx init */ 



/* 


********1 


* 

* TITLE: 

* 

* FUNCTION: 

* 

* 

* 

* INPUT: 

* 


lLC TRANSMIT PROCEDURE 

Receives all messages airecteo to the LLC transmit 
orocess for a layer instance. It then determines 
the correct procedure to C3ll to orocess the request. 

Pointer to message 

Mailoox name --what for ? 


* 


* OUTPUT: 


* ............LLC Transmit Process ... 

* This is the ooerational transmit process code for each lLC 

* layer instance. Mailoox messages transmiteo will oe decoded oy 

* the switch statement into procedure calls for the cases listen 

* oelow. each call will pass a pointer to the message and the 

* pointer to the L IC A taole as parameters. 


******* 


*/ 


/* Retrieve the Layer Instance Common Area pointer *7 
/* DO CASE on message type */ 

/* CASE An IOLD request message */ 

/* Call common routine to transfer LCSI to LACS from IOLD msg */ 
/* uocate IOLDs counter for tx for statistics */ 

/* SHOULD 3£ RECEIVING AND CHECKING AN ERROR CODE HERE */ 


/* CASE Tne request to DMA a LCSI to the LACS has returnee */ 

/* upoate LC3 to lac tx counter for statistics */ 

/* Call procedure to interpret new LCSI */ 

/* SHOULD 3E RECEIVING AND CHECKING AN ERROR CODE HERE */ 


/* CASE The request to DMA a buffer descriptor to the LACS has returned 
/* Call routine to fetch data ouffer from L6 */ 

/* SHOULD 3E RECEIVING AND CHECKING AN ERROR CODE HERE */ 


/* CASE The request to DMA a buffer to the LACS has returned */ 

/* update 3UF to lac tx counter for statistics */ 

t* Call routine to create LLC PDU and deliver to the MAC layer 

/* SHOULD SE RECEIVING AND CHECKING AN ERROR CODE HERE */ 

/* CASE The LACS Network Layer has a Data Request for LLC */ 

/* Call routine to create LLC PDU and deliver to the MAC layer 
/* SHOULD 3E RECEIVING AND CHECKING AN ERROR CODE HERE */ 

/* CASE The request to DMA a LCSI to the Lb has returned */ 

/* Call procedure to terminate LC3I and free all memory 
/* update LC3 to 16 tx counter for statistics */ 

/* SHOULD THIS JUST 3£ "return_lcbi'* procedure call 
/* SHOULD 3E RECEIVING AND CHECKING AN ERROR CODE HERE */ 

/* CASE Tne MAC data request nas returned as 
an error or a confirm error * 

* Call procedure to handle error and free all memory * 

* SHOULD 3E RECEIVING AND CHECKING AN ERROR CODE HERE * 


*/ 


*/ 


*f 

*/ 


*/ 


*/ 
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c 


/* OTHERWISE */ 

* Tne message can not be decoded into any that are expected oy this 

* process. 

* At this stage/ the so ace used by the 

* message is returned to the Kernel 

* until a method is designed to handle the proolem. 


* / 

/* END CASE End of tne message type decoding */ 

> /* switch */ 

> /* llc_tx */ 

/* -Meguous Interface--- 

/ * The request to DMA a L C u I from the L 6 to the LACS has returned */ 

/ * 

* TITLE: INTERPRET TRANSMIT LC3 REQUESTS PROCEDURE 


*/ 


pUNCTION: 


* 

★ 

* 

* 

c 

* 

* 

* INPUT: 

* 

* 

* OUTPUT: 

* 


Receives all O'!A confirm messages due to the comoletion 
of a transfer of a LCSI to the LACS memory. This 
routine determines if any other transfers are required 
to fetch the data associated with the request. When 
the data is contained in the LCS/ this procedure 
fetches a buffer to treansfer the data to MAC/ attaches 
a LLC header and issues a data request to MAC. 

Otherwise a request is maae to transfer the oata buffer 
or the ouffer descriptor to the LACS. 

Pointer to message 

pointer to the layer instance table 


*/ 



/: 


* This message nas been returned from DMA services. The following 

* code will check the results of the transfer request and if it was 

* successful. 


*/ 

/* IF the request was successful */ 

/* THEN */ 

/ * DO CASE on the function specific function code */ 

/* CASE of Connectionless Transmit request */ 

/ * DO CASE on the tyoe of data buffer in LC3I */ 

/* CASE of data buffer contained in the LCB */ 

/* fetch a buffer to move the data to MAC */ 

/* Set the total range */ 

/* Get a ouffer tnat is the requested 

length ♦ 4 bytes for headers */ 


/* allocate extra head 32 oytes ana tail 123 bytes */ 
/* space for mac handle small buffer M. Lu */ 
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lu */ 


/ * Seduce the suffer size by 4 bytes for DMA * / 

/ * anc extra header space for mac continguous suffer */ 

/ * here because the ole kernel not garantee return 
new Duffer discrioter * / 

/* so we keeo using the ola one. 

net legal for the new kernel M . lu * / 

/* now load in the oata to buffer */ 

/* reserved space for data in led */ 

/* Clear all remaining fields */ 

/ * Format it as a LLC unnumbered information frame */ 

/♦Issue it as a *4 AC a at a request */ 

/ * Comolete the LC 31 status ana completion word */ 

/* Issue massage to the DMA */ 

/* set tne reaa credit count for Ico user flow control */ 

/* Set the LCBI completion oit */ 

/ * Return the LC31 to L6 memory * / 

/* CASE of data buffer pointer(s) contained in the LC3I */ 

* Wnen the buffer pointer is in tne LC3Ir the buffer 

* containing the message must be transfered across from the lb 

* to LACS buffer memory. Space is allocated for the message and 

* a request submitted to DMA services to maxe the move. 


/* Request the buffer oe transferred from the L6 */ 

/* Have the message return to the DMA done mailbox */ 

/* Set priority to normal */ 

/* Set the number of L6 buffers */ 

/* Initiailize total range to zero */ 

/* DO FOR all buffers in the LC3I */ 

/* Set the L6 buffer descriptors */ 

/* Set the Lo buffer range */ 

* There is a problem if the total range exceeds 3 2K words 

* fortunately LLC will always oe less OUT 

* DO WE NEED TO VALIDATE RAN3E anc 

* WHAT ABOUT LCd FORMAT ? (3-2 or 16 oits) 

* and WHAT ABOUT LC3 FORMAT -short now 


/* Set the total range */ 

/* ENODO */ 

> /* switch */ 

/* Set a buffer that is the requested 

length + 4 bytes for headers */ 

/* allocate extra head 5Z bytes ana tail 123 bytes */ 

/* space for MAC handle small duffer M. Lu */ 

/* Reduce the ouffer size by 4 bytes for DMA */ 

/* ana extra header space for mac continguous buffer */ 
/ * here Because the old kernel 

not garantee return new buffer discrioter */ 

/* so we keep using the old one. 

not legal for the new kernel M. lu */ 

/ * Clear all remaining fields »/ 
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/* Send the request message to 09A services */ 

/ * special routine for LLc_trans release */ 

> /* else if full*/ 

/* CASE of 3 suffer jescriotor pointer contained in the LCSI */ 

* When a duffer descriptor pointer is in the LCEIr the suffer 

* descriptor must oe transferee across from the L6 

* to LACS buffer memory. Space is allocated for the message and 

* a request submitted to DHA services to make the move. 

* 

* This is identical to the LC3 transfer performed by the XOLDs 

* procedure. 


( 


*/ 

/* 

/* 

/* 

/* 

/* 


from the L6 */ 


Request trie ouffer be transferred 
Set invalid status in the LCSI */ 

set the write credit count for Ico user flow control */ 
Set tne LCSI completion bit */ 

Return the LCSI to Lo memory */ 

/* OTHERWISE */ 

* Can not decode the buffer type into anything 

* that can oe processed by this function. Update the LCSI 

* status to reflect the problem and return the LCBI to 

* the Lo. 

* / 

/* Set invalid status in the LCBI */ 

/* set tne write credit count for Ico user flow control */ 

/* Set the LCBI completion bit */ 

/* Return the LCBI to L6 memory */ 

/* ENDCASE */ 

> /* switch */ 

/* OTHERWISE */ 

/* Only a connectionless transmit request is currently supported */ 


* Can not decode the requested function into anything 

* that can be processed by this function, update the LCBI 

* status to reflect the proolem ana return 

* the L6. 


the LCBI to 


> 

/ * 



/* 


*/ 

/* Set invalid status in the LCBI */ 

/* set the write credit count for leb user flow control */ 
/* Set the LCBI completion bit */ 

/* Return the LCBI to L6 memory */ 

/* ENDCASE */ 

/* switch */ 

ELSE */ 

/* Set invalid status in the LCBI * / 

/* Try to uodate status in LC3 ana free memory or something 
ENDIF */ 

/* xmit_lcbi_to_lac */ 


*/ 


> 
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1 **★* i 


*r ★ * * iritititititititlcltitie \ 


**/ 


/*-----Megabus Interface - 

/* The L_0ATA.request transaction has returned fromm the LLC layer as a 
* l_ 0ATA.confirm. The ouffer and message memory must be released. 


*/ 


*/ 


* This message is the returning MAC_conf or MAC error. 

* Release tne buffer space * 

* Return the MAC message to LACS memory * 


/*------ Megabus Interface---*/ 

/ * The request to DMA a data buffer from the Lo to the LACS has returned */ 

/ * 

* TITLE: ISSUE MAC DATA REQUESTS =>.R0CSDUR£ 


« 

* fUNCTION: 

* 

★ 

* 

* 

* 

* 

* 

* 

* 

* 

* 


This routine is invoxeo when a buffer is available 
to oe issued to MAC as an LLC PDU. Checxs are made 
to male sure that the layer instance and the LSA ? are 
in the INUSE state. All validation of the request 
is performea* such as PDU Dara.meters* local PDU limits 
remote LSAP limits and parameters* etc. A LLC 
header for an unnumbered I frame is appended to the 
suffer and passed to the MAC layer mapped to this layer 
layer instance. The LC3I is then marked completed and 
the DMA firmware is requested to transfer it back to 
the Lo. 


* 

* 

* 

* 

* 


INPUT: 


OUTPUT: 


Pointer to message 

pointer to tne layer instance taole 


The request to DMA 


a buffer from the L6 has returnee 


*/ 


/ it it \ 


it 


* This message is returned oy DMA services when it completes the 

* transfer of a Duffer from the Lo to the LACS Doaro as oart of a 

* transmit transaction. This step will ado the LLC layer addressing 

* to the message and send the Ipdu to MAC for transmission. 


*/ 

/* Clear an error flag */ 

/* Validate that the transfer was succesful */ 

/* IF the transfer was not a success */ 

/* Set the state of the LSA? and Layer Instance accordingly */ 
/* Set LC3I status woras */ 

/* set the write credit count for leb user flow control «/ 

/* Set the LC3 status to completed */ 
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/ * Return the L C 31 to Lb memory * / 

/* R e o o r t a DMA failure * / 

/* Set error cose */ 

/* £<-3= every tninj is honxy-dory */ 

/* Set a pointer to the local and remote 

Is ao taoles into transaction site. * / 
t * Masking M3 16 bits of leg 

ador.is restrictive out might save some grief * / 
/* Call procedure to validate the data request */ 

/* set the write credit count for led user flow control */ 

/ * set error code * / 

/* Set status in the LC3I 
/* Call procedure to transfer completed LC3I 
/★ Fetch tne address of the local taole 
from the layer instance local LSAP directory */ 

/* Fetch the aoaress of the remote taole 
from the activate directory of the LSAP */ 

/ * update Jl.tx counter for statistics */ 

/ * Call oroceoure to create p Q U and issue it to MAC 

/* IF no errors have been detected yet */ 


c: 


/* THEN 

* 

* Update Local $A? statistics 

* 

*/ 

/* Update Layer Instance statistics 
/* 

* If Remote 

★ 


SAP Statistic flags indicate to always collect 

statistics or only if local SAP indicates to 
collect it on the remote 


/* £ 


/* 

/* 


*/ 

/* 

/* 

/* 

/* 

/* 

/* 

£ LS £ 


SAP statistics 


THEN */ 

Upcate remote 
E N 01F 

set the write credit count for Ico user flow control */ 
Set status in the LC3I 

Call procedure to transfer completed LC3I 
Error */ 


*/ 


*/ 


* / 
*/ 


t* set the write credit count for Ico user flow control */ 
/* and error */ 

/* Return the LC3I to 16 memory */ 

END IF */ 

ENDIF */ 


/* ---—-Megaous Interface 

/* Validate a LLC transmit data request procedure 
* 


* / 


TITLE: 


VALIDATE LLC DATA REQUESTS PROCEDURE 


FUNCTION 


This routine is invoked when a buffer is available 
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* 

* 

* 

* 

* 

* 

* 

* 

* 


INPUT: 


OUTPUT: 
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to be issued to T A C as an LLC ?0j. Checxs are mace 
to mane sure tnat the layer instance and the USA? are 
in the I MUSE state. All validation of the request 
is performed* such as 3 DU parameters* local 3 D'J limits 
remote LS A ? limits and oaram*eters* etc. 



Pointer to transaction bloc* 
pointer to the layer instance taole. 


** ** 1 


*/ 


/* Clear an error flag */ 

/* Validate the logical address of the remote and local SAPs */ 

/* IF the local log. SAP aodr. is greater than the local LSA? dir. size 
/* Report a failure */ 

/* Set error code */ 

/* END IF */ 

/* IF the remote logical SAP ador. 

is greater than the remote LSA? dir.sz. */ 

/ * Reoort a failure * / 

/* Set error code */ 

/* ENDIF */ 

/* Validate the state of the layer instance */ 

/* IF the' layer instance is not in tne INUSE state */ 

/* Set tne state of the LSA? and Layer Instance accordingly */ 

/* Set LC6I status words */ 

/* Report a failure */ 

/* Set error code */ 


/* END IF */ 

/* Validate that the local SAP exists */ 

/* IF the local LSA? does not exist */ 

/ * Set the state of the LSA° and Layer Instance accordingly */ 
/* Set LCdl status words */ 

/* Report a LSAP failure */ 

/* Set error code */ 

/* END IF */ 

/ * Validate the state of the local LSA? */ 


/* IS THERE A PR08LE* HERE IF THIS CODE IS EXECUTED EVEN THOUGH 


SAP IS NON-EXISTENT 


access undefined memory 
- bus error 


*/ 

/* IF the major state of the LSA? is not INUSE */ 

/* Set the state of the LSA* 3 and Layer Instance accordingly */ 
/* Set LCtil status words */ 

/* Report a LSAP failure */ 

/* Set error code */ 

/* END IF */ 

/* Validate that the LSA? limits are not exceeded */ 


*/ 
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( 

/ * IF the P D U size exceeds the 
/ * Set the state of the u 5 A 
/* Set LCBI status words 
/* Report a 3 DU failjre */ 

/* Set error cooe */ 

/ * E N D I F * / 

/ * Validate the Remote LSAP 
/* IF the Remote SAP is not active 
/* Set the state of the LSAP and 
/* Set LC3I status woras 
/* Report a LSAP failure */ 

/* Set error code */ 

/* END IF */ 

/* Just watch how */ 

/* Return with error code 
> /* valiaate.data.req */ 


: l/11 c_xmit.:.oal 5 a«e IQ 

maximum P D li size * / 

ana Layer Instance accordingly */ 

*/ 


*/ 

*/ 

Layer Instance accordingly */ 
*/ 


*/ 


* */ 
*/ 

/* 

* TITLE: FORMAT UI LLC PDU PROCEDURE 


/ 

/* 


LLC SAP Component 


Receives a transaction block containing a pointer to 
a Duffer of data. The source and aestination 3re 
are aadeo to the LLC header and the unnumbered 
control header is added. A MAC data request message 
is preoared and issued to the MAC transmit process 
mailbox. 

Pointer to LLC transaction block 
Pointer to layer instance taole 

Error Cooe 



* The message is a LLC transaction olock complete with oointers to t h ? 

* the local LSAP table* the remote LSAP taole* the LC5I and the ouffer. 

* / 

/* Allocate memory for a MAC data request message */ 

/* Set the message type into a MAC DATA.request */ 

/* Set the priority */ 

/* Set the return mailoox ID */ 

/* SHOULD THIS BE NULLED ???★/ 

/* / ??? mac_dreq_msg->return_id = lica_p->xmit_mbx; */ 


C 


FUNCTION; 


* 

X 

X 

* 


IN»UT: 


OUTPUT: 



/* Add 3 D/tes of LLC address to the begining of the buffer */ 

/* for LLC header - what about MAC */ 

/* Add the LLC addressing (remote and local SAPs) to the PDU buffer */ 
f* Use a type I unnumoered I-frame command */ 

/* Set the class of service into the message */ 

/* Move the aestination MAC acaress into the message */ 
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/* NcSO TO TAL< ABOUT THIS _ WOULD COPY BllfFzR m Ofi< SETTER */ 
/* Set the message suffer descriptor address to point to the LlC 
/* Sena the transaction to MAC for transmission */ 

/* free tne message */ 

/* update message droooeo counter */ 

/* free the message */ 

> /* else if MSXfull */ 

/* Return */ 

> /* iss_mac_dreq */ 


PDU */ 




17 15:40 193o 


/jsr/dvtp/lLc_p3l/llc_canat.h.03l Page 


/ * 

* This file (llc_const.h) defines the constants used in 

* Layer processes for the LACS coara. 

*/ 


1 


the LLC 


/ * define commanas/ next read/ next received/ poll-final bit masks * / 

/* for LlC frames. (See struct llc.frames) */ 

/* Suoervisory frames */ 

/* Supervisory bit */ 

/* Receiver Ready command */ 

/* Reject command */ 

/* Receiver Not Ready */ 

/* Poll-Final*/ 

/* Next Received count */ 

/* Information frames */ 

/* Information oit */ 

/* Next Sena count */ 

/* Poll-F inal */ 

/* N_r_ 0XFS00 Next Received count*/ 

/* Unnumbered Frames */ 

/* Unnumbered oits */ 

[ /* Set Async 3al Mode Ext */ 

/* Disconnect */ 

/* Unnumoereo Acknowledge */ 

/* Disconnect Mode */ 

/* Frame Rej ect */4 
/* Exchange ID P bit clear */ 

/* Exchange ID P bit set */ 

/* Test command P bit clear */ 

/* Test command P bit set */ 

/* Poll-Final */ 


/* Length of UI PDU Header */ 

/* add special for mac layer send small package/ preallocate header 32 bytes */ 

/* M. Lu 2/36 * / 

/* 123 oytes more tail for mac */ 

/ * ait masks for words in the LC3I memory block (See struct lcbi_mblk) */ 

/* The interruot cbntrol word (cbicw) */ 

/* 3its 0-7 Channel */ 

/* 3its 8/9 CPU */ 

/* aits 10-15 Intr level */ 

/* The function coae word (cbfsf) */ 

/ * 3it mask for function codes */ 

p- /* Values that may appear in the function code field */ 

L /* Connectionless Receive function code */ 

/* Connectionless Transmit function code */ 

/* -vent function code */ 
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/* Activate Local function cole * / 

/* Activate remote function code */ 

/ * Deactivate Local function code */ 

/ * Deactivate remote function code */ 

/ * Activate for Local or remote function cole * / 

/* The controller status word Icocts) */ 

/* Invalid function code */ 

/* RAM memory exhaust */ 

/* RAM location non-existent */ 

/* RAM parity error */ 

/* l 6 memory yellow */ 

/* Non-existent L6 memory */ 

/ * i_6 ous parity error */ 

/* L6 memory red */ 

/* The function specific status word (cbfss) */ 

/ * SAP not active */ 

/* Lack of resources *t 
/* Controller unavailable */ 

/*SM error*/ 

/ * SAP already active */ 

/* undefined */ 

/* 3A° already deactivated */ 

/* Receive ouffer too small */ 

/* Illegal logical address */ 

/* Inva lid LCd */ 

/* Write credit violation */ 

/* Read credit violation */ 

/* The completion word (cOcds) */ 

/* Completion bit */ 

/* LC3 not processed */ 

/* bit masks for the I3LD command word */ 

/* The "range word" */ 

/* function cade */ 

/* Length in bytes */ 

/* The "Channel Number or Layer Instance Number" */ 

/* Controller address */ 

/* Layer number */ 

/* Layer instance */ 

/* Index values for the Function Directory Mailbox array */ 

/* See struct lica* element fc_mbxLl6] */ 

/* Receive */ 

/* Transmit */ 

/* -vent */ 

/* Activate */ 

/* Deactivate */ 
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c 

/+ Data Puffer type aefinitions - NEED TO COORDINATE wITh Lo 

/* Data Suffer pointer(s) in tne LC3 */ 

/* All oata contained in the LC3 */ 

/ * Suffer Descriptor pointer in the t_C0 */ 

/* L3A? Taole indicator flag definitions */ 

/* Activate remote saps dynamically */ 

/* no more read credits can accepted */ 

/ * oac leb set uo pit *7 

/ * LCai completion status »/ 


/* LLC Layer Numoer 
/* LLC Layer number 

/* Tne definition of 


*/ 

is eaual to 2 «/ 

'instance numbers' */ 


/ * The conditions under wnich messages age out are defined here * 
/ * Alarm period */ 

/» Aoout 6 minutes */ 



Maximum directory sizes */ 

/* 64 for time being * / 

/* until a better suggestion 
/ * who knows when 


*/ 

*/ 


/* States for local LSAPs */ 
/ * .Active state * / 

/« Inactiiive status */ 

/* MAC error code */ 


/ * ERRORS and success 
/* success 


*/ 


*/ 


/* 

/* 

/* 
/* 
/ • 
/ * 



9Ad function spec, ^unction code */ 

Invalid function code */ 

/* Sad layer instance state */ 

3ad or unknown remote SAP */ 

Sad or unknown local SAP */ 

SAP already active */ 

SAP deactivated */ 

/* Multiple activate requests on SAP */ 
/* Bad remote SAP state */ 

/* dad local SAP state */ 

/* create local Isap error */ 

/* create remote Isao error */ 

/* SAP not available for services */ 

/* Bad OSAP in received PDU */ 

/* Bad SSAP in received PDU */ 

/* 3aa DMA transfer of data buffer */ 
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/* a ad DMA transfer of Suffer oesc. 
/* baa transmit request o e s c . * / 

/* a a o P D l) site */ 

/ * LC5 Duffer size too small for PDU */ 

/ * 3 a a D 3 A ? state * / 

/* PDU exceeds max PDu size */ 

/* recieve transmit queue *ull */ 

/* invalid transfer */ 

/ * return Icoi error * / 

/* baa lebi response - Dig err */ 

/* incrrect venue value */ 

/* data too long for data in lco */ 

/* DMA of 3 duffer failed */ 

/* baa register mail box directory */ 

/ * 0aa received P D U * / 


/* 

inv3 lia 

SM request */ 



/* 

xid transact 

ion error 


f * 

xid respouno 

error 

*/ 

/* 

unxnown 

message type 

*/ 


/* 

a a a i o 

message */ 



/ * 

invalid 

SM return mail oox 

*/ 

/* 

3M return mailoox fu 

ll */ 


/* 

invalid 

DMA mail oox 

*/ 



/ * DMA return mailbox full ★/ 

/* invalid MAC mail box */ 

/* MAC return m 3 i l d o x full * / 

/* genaric default error */ 

/* getouf could not allocate */ 
/* allocate no mem avail */ 

/* resolve mail oox faileo */ 

/★ registe mail oox failed */ 

/* mail box turn on failed */ 

/* mail box turn off failed */ 

/ * mail box delete failed * / 

/* send massege failed */ 

/* lie layer event coae */ 


*/ 


/* No maten on a ssaren address or name «/ 

/* for error but not exit return/ to calling */ 



c 
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/ * ★ i 


’ «r * * *-*★★★***< 


* This file(llc_struct.n) define the structures used in tne 

* i_LC Layer processes for the LACS c oara. 

* / 

/* define a structure for LLC frames */ 

/■k + hniclitlcitltlt’kltltitltltit+itirlt'k’kniitititititlcifit'kHlt + *■** + ****+' 


/* 

/* 


a LSAP taoLe */ 


/* 

/* 


< 


/♦ Structure for supervisory commands */ 

/* Structure for unnumcered commands */ 

/* Structure for determining PDU type */ 

Define a structure used to enqueue ILc.trans on 
Define a structure for LC3I memory olocks */ 

/* Read LC3 information */ 

/♦ Write LC3 Information */ 

/* Data Arrival event information */ 

/♦Additional write credits event information */ 

/* SAP error event */ 

Define a structure for a ouffer descriptor image */ 

Define a structure for remote LSAP tables */ 

/* NEED TO REORDER FOR STANDARDIZATION */ 

/ * 

Bit 0 - Maintain Stats on all requests 
Sit 3 - Maintain Stats if Local match 
Sitlo “Dynamic RSAP 


♦ / 


/* 

/* 


/• 
/ ♦ 


/* THE FOLLOWING STATS FOR REMOTES MUST 3E REVISITED 
Define a structure for a remote LSAP directory */ 

/♦ NEED TO REEXAMINE FOR CORRECTNESS 
Define a structure for local LSAP taoles */ 

/♦ NEED TO REORDER FOR STANDARDIZATION 

/♦ 


/* 


*/ 

Define a structure for a local 

/♦ NEED TO REEXAMINE FOR CORRECTNESS 


♦ / 


♦ / 


ait 

3 

- 

Maintain Stats on this 

LSAP 

Bit 


- 

Maintain Stats on Remotes 

Sitl 3 

— 

Megaous Exposed LSAP 


Bit 

0 

- 

Report Data Arrival 


Bit 

1 

- 

Report Write Credits “ 

N/A 

8i t 

2 

— 

LSAP Errors 


LSAP 0 i r ec 

ti 

or y 

*/ 



*/ 


/* 


A structure for the LLC Instance Common Area */ 

/♦ Mailoox IDs used by the LLC layer */ 

/♦ Local LSAP directory pointers * / 

/♦ Remote LSAP directory pointers */ 

/* layer emergency event message otr */ 

/♦ Remote LSAP event counters */ 

/♦ Layer Instance Parameters ♦/ 

LLC layer transaction structure. The top of this structure is 
a union of several message types used in the processing of a transaction. 
Pointers to other memory blocks are carried along with the transaction 
to reduce the decoding ana table Lookup that would otherwise oe required. 
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/* extern (lacs.csl) LAC3 software crash error log reserved location */ 
/*-’— 


/* lie layer 0 error message stack * / 
/* extern lie LAYER 1 reserved block */ 

/* lie layer 1 error message stack */ 
/* extern lie LAYER 2 reserved olock */ 

/* lie layer 2 error message stack */ 
/* extern lie LAYER 3 reserved clock */ 

/* lie layer 3 error message stack */ 


{ 
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/* 

* This file (11cincludes.n) is the master include file for LLC Layer 

* orocesses. The header files usee are listed below. 

* / 


/ * 

Include 

all 

kernel neader files */ 


/ * 

Include 

all 

LACS 

message definitions 

*/ 

/* 

Include 

all 

Station Management header 

files 

/* 

Include 

all 

megabus header files */ 


/* 

Include 

all 

mac 

header files */ 


/* 

Include 

all 

LLC 

Layer macros */ 


/★ 

Inc lude 

all 

LLC 

Layer constants */ 


/ * 

Include 

all 

LLC 

Layer structures */ 



( 
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/ ★★★★★★★★★★★★★★★ ^r#r-*lr-Hr ^r-^r -Jlr-tt <lrtlr^ r 

★ ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★HrHri 

* ★ Hr 


* ★ ★ 


★ Hr ★ 

★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★★ 
Hr ★ ★ 

★ ★nr 

★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 

★ ★ Hr 

★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
Hr ★ ★ 

★ ★ nr 

★ ★ ★ 
★ ★ ★ 

★ ★ nr 

★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 


HONEY WELL 

Local Area Network 

LOGICAL L I N < CONTROL 
LAYER 

mac layer interface module 


Copyright: Honeywell Information System 
All rights reserveo. 


Cere ate date: 
3y : 

D iscription: 


3/25/36 
M. Lu 


Functions 4 Parameters 


Revision A: 
date: 

3y: 

Di script ion: 

Revision R: 
date: 

■3y: 

Discription: 


*/ 


/ 

/* 

★ 

★ 

★ 

★ 

★ 

★ 

★ 

★ 

★ 

★ 


TITLE: 

FUNCTION: 


**■*■* : 


SEND ACTIVATE MESSAGE TO MAC LAYER PROCEDURE ‘ 

All mailooxes are turned off until the MAC 
activate message is returned. This is to prevent 
a number of MAC activate reouests being sent due 
to multiple activates received. A special MAC 
Activate mailoox is created to return the message 
frrom MAC. The activate message is sent to the 
MAC layer manager and the lLC Activate message is 
sent back to the LLC mailbox. 



Se j 

c 


* 
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local L 3 A P . 


* I \ 9 U T: Pointer to layer instance taole 

★ 

* OUTPUT: 

* 


**<trHr*Hr***lfc i 


★ / 


/ * Create ana Store 

MAC registration mailbox to oe useo for a one time message*/ 
/★ set limit to one message before full ★ / 

/★ Allocate some space for a MAC query message ★ / 


/* 00 CASE on the layer instance number of 
/ * CASE Instance 0 * / 

/* Set MAC mailoox 10 for layer instance 0 ★ / 


/* CASE Instance 1 ★ / 

/* Get MAC mailoox 10 for layer instance 1 */ 


/* CASE Instance l */ 

/★ Get MAC mailoox ID for layer instance 2 ★ / 


/★ 


CASE Instance 3 ★ / 
/ ★ Get MAC mailbox 


ID 


for layer instance 3 */ 


/* OTHERWISE ★ / 

/ ★ UnKnown instance nuioer/ fatal error ★ / 
/★ ENDCASE */ 

/* switch ★/ 


/* Sena message to MAC layer manager ★ / 

/★ Declare the message type to be 'mac activate' ★ / 

/* Set the priority and clear the buffer descriptors ★ / 

/* rill in mailoox for DATA.inaicate messages */ 

/★ Clear the returning mailbox IDs */ 

/* Declare the return mailbox */ 

/ * Send the MAC query message ★ / 

/★Return ★/ 

> /* mac_activate ★/ 


/★ 

* 


TITLE: 


-- LLC Layer Management -— 

MAC REGISTRATION COMPLETE PROCEDURE 


★ / 
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* 

* FUNCTION: 

* 

* 

n 

* 

* 

* 

★ 

Hr 

# 

* INPUT: 

* 

* 


The MAC activate reauest message has returned 
completes to LwC . A successfully completed request 
contains tne mailoox io for *AC data reauest mailbox 
which is saved in the layer instance table. All 
LLC nailooxes are turned ana the m3c registration 
mailoox is deleted. Tne state of the layer instance 
is set to In-Use state. An unsuccesful completion 
of tne MAC registration will cause tne state of the 
layer instance to de set to ????(DISA8LED??> 

Pointer to message 

Pointer to LLC common layer instance table 


* OUTPUT: 

* 

* ...LLC Layer Management..... * 

* MAC_aCTIVATE_C 3M 3 L£T£0.request message 

*/ 



/* Turn on LLC LME mailooxes used during normal operations */ 

/* Delete MAC activate message mailbox */ 

/* IF the registration was a success */ 

/* ELSE 
/* END IF */ 

/ * Release the message block to free memory */ 



/* RETURN */ 

> /* mac_act_comp */ 


/* -- LLC SAP Component -— --— -—-*/ 

/* A MAC_0ATA.inaicate message */ 

/ * 

* TITLE: PROCESS A MAC DATA INDICATE PROCEDURE 

# 

* FUNCTION: A mac data indicate message is recieved with 

* a ouffer of data intended for an LSAP. The 

* type of PDU is determined and processed accordinly. 

* For unumoer information frames* the LLC header 

* information is stripped off and delivered to the 

* Net worn layer or across the Mtgabus if a read LC31 

* is available. If there is no LC3I available the message 


* is queud as Dart of a transaction olock until one is 

* availaole. 

* 

* f 

* INPUT: Pointer to MAC data indicate message \ 

* a ointer to Layer Instanc? coimon table 
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OUTPUT: 


Error status 




/* Point to the ouffer */ 


/* 00 CASE on the frame tyoe received * / 

/* CASE of Unnjmoered information frame */ 

/* Call procedure to validate the ?0u request for this SAP */ 
/* IF it is a valio PDb */ 

/* Then 

/* Fetch the local LSAP tacle 

ignore group addresses for now */ 

/* increase UI_rx counter */ 

/♦Fetch the remote Isap tasle *7 

/* IF local LSAP is mapped to a LACS network layer */ 

/* THEN * 

/* Call procedure to strio off LLC header *, 

/* Create a llc_aata_indicate message to oe 
delivered to networn */ 

/* Send message to mailoox in LSAP taole for Networx */ 


> /* if l_lsap_tbl->net_mbx NULL */ 

/* ELSE IF Megaous interface an: a reao LCB is availaole 

/* Dequeue the first LCdl */ 

/* update the queue counter */ 

/* DO vIHILE the LC8I does not have a ouffer large enough 
to hold the data or LCBI read queue is not empty */ 

/* Set status in LC3I to indicate buff too small */ 

/* Set actual size of buffer */ 

/* Icoi ! set the read credit count for 
Leo user flow control */ 


/* Set LC3i completion pit 
/* Return LCBI to the L6 


/* Dequeue the next LCBI from read LC8I queue 
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/« update the queue counter */ 

> /* unite*/ 

/ * IF LC3 bjfferls) can contain all of POO * / 

/* THEN everything is okey cokey */ 

/* Complet tne LCSI status */ 

/* Set the actual size */ 

/* Set tne remote logical address */ 

/* lcoi - trans->lcbi_olK->lcbi_tyoe.read_lcpi.cblra = 
r _lsap_log_aaor;*/ 

/* Strip off LLC header from PQU 

/ * Call procedure to complete remainder 

/* Fix initial mac.inc FFFFF err. M. Lu. 3/56 */ 

> /* if cbtrg */ 

/ * ELSE last LCSI Puffer too small and no 
available LC3S left on queue */ 

/* Create LLC transaction plock for ?DU */ 

/* Allocate some space for a LLC transaction block */ 

/* Save a pointer to the MAC indicate 

message in the trans. oik. */ 

/* Save the LSAP table pointers ana what else */ 

/* save remote sap logical addr */ 

/* save local Isao table aadr */ 

/* save remote Isao taole aaar */ 

/* Clear the LC3I pointer since tnere is not one known yet */ 

/* Strip off LLC header from ?DU and set 
ouffer desc into trans.blk */ 

/* Send LC3I tranaction olock back to the L6 */ 

/* Clear the oata buffer in the transaction .blk */ 

/* Set actual size of buffer */ 

/* Set status in LC3I to indicate buff too small */ 

/* Icoi set the read credit count for Ico flow control */ 

/* Set LC3i completion bit */ 

/* Return LC3I to the L6 */ 
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/ * I r d a 13 arrival event is to oe 

reoort?c ana an event *_ C 31 is h a n c y * / 


/* Tnen */ 




/ * Queue MAC indicate transaction olock on 
pdu waiting aueue */ 

/* Fetch and clear event LCBI pointer from 
LSAP table */ 

/* Set buffer size and event status into LCfll */ 

/* Retjrn ICSI to th Li */ 

/* Start ageing of message */ 

/ * £LS£ IF data arrival event is to be 

reported out there is not an event LCBI available */ 

/* Queue MAC inaicate transaction 

oloclt onto event data arrival queue */ 

/*■ Start ageing of message */ 

f* ELS: */ 

/* cneck bound limit */ 

/* over the bound limit# drop the request */ 

/ * update the odu packet dropped */ 

/* dump the trans ol< */ 

> /* if bound li */ 

/* update the aueue counter */ 

/ * Queue MAC indicate trans block on to 
pdu waiting aueue */ 

> /* else */ 

/* Clear the aging counter ????????? */ 

/* Start ageing of message */ 

f* END IF */ 

> /* if.else cotrg */ 

/* EMOIF */ 

> /* if_else_if */ 

/* ELSE must be Megaous interface but no outstanding read LC3 */ 
/* Create LLC transaction olock for PDU */ 


/* Allocate some soace tor a LLC transaction olock */ 
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/* Save a pointer to the MAC indicate 
message in the tr 3 ns. 5U. *f 

/* Save the L 3A 3 taole pointers and what else */ 

/ * save remote sao logical a d d r */ 

f* save local Isap taole aoor */ 

/ * save remote Isao table aocr */ 

/* Clear the LC3I oointer since there is not one known yet */ 

/* Strip off LLC header from 3 DU 

and set ooffer oesc into trans.olk */ 

/* IF data arrival event is to oe 

reoorted ana an event LC5I is handy */ 

/♦Then * / 

/ * Queue MAC indicate 

transaction olock on pdu waiting queue ♦/ 

/* Fetch and clear event 

uC 31 pointer from LSAP table */ 

/* Set ouffer size and event status into lCBI */ 

/* Return LC3I to th Lo */ 

/* Start ageing of message */ 

/* ELSE IF data arrival event is to oe 

reported out there is not an event LC3I available ★/ 

/* Queue MAC inaicate transaction 

bloc* onto event data arrival Queue * / 


/* 

Start 

ageing of message 

*/ 

/* 

ELSE 

*/ 


/* 

check 

oouna limit */ 



/ * ov 

er the bouna limits 

droo the request */ 


/* update the pdu packet dropped */ 

/* dumo the trans blk */ 

> /* if */ 

/ * update the queue counter */ 

/* Queue MAC inaicate trans block 

on to pdu waiting queue */ 

> /* else */ 

/* Clear the aging counter ????????? * / 

/* Start ageing of message */ 

*/ 


/* EMDIF 
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/* END IF */ 

/♦ELSE an error must have occurred * / 

/* WHAT AaQUT iTUS */ 

/* Drop the incoming oou/’ the LSA? is not defined */ 

/ * free the .’IAC message * / 

/* END 11F */ 




/* CASE 

of an XID 

=»0J a 

bit clear case 

*/ 




/* CASE 

of an XI0 

PD U ? 

oit set case 

*/ 



/* 

CASS of a 

TcST pd J 

P oi t 

clear case 

*/ 



/* 

CASE of a 

TEST pda 

p oi t 

set case 

*/ 



/* 

OTHERWISE 

itmust oe 

a very dad p DJ 



/* 

ENiDCAS £ 





*/ 

> 



/ * switch 

*/ 




> 



/* mac_ind 

*/ 





c 
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kk k 

* * k 
kk k 

*** HJNEYWELL 

kit k 

*** Local Area Network 

kkk 

kkk LOGICAL LINK CONTROL 

*★ * 

kk k LAYER 

k k k 

*** transport - network layer 

*** interface module 

k*k 
kk k 

**-* Copyright: Honeywell Information System 

★ ** All rignts reserve:. 

kk k 

*** Cereate Date: 3 / 25 / 3 o 

** * 3y: M. Lu 

*** Discriotion: 

k k k 

**+ functions 4 Parameters: 

kk k 
kk k 

*** Revision P: 

*•* * Date: 

*** By: 

*** Discription: 

k 

*** Revision P: 

** * Date: 

** * ay : 

*** Discription: 

** * 

*** 



*/ 


/ * 

* TITLE: TRANSPORT LAYER INTERFACE ACTIVATE LSAP PROCEDURE 

* 


* FUNCTION: 

* 

* 

* 

* 

★ 

* 


Receives an activate LSAP request message » from tran 
local lsap request cause a search of the local LSAP 
directory to insure the LSAP exists 3nd the LSAP 
has not seen previously activated or in a state /f 

prohibiting service to the user. Remote Isao requests v 
are also checked to insure the LSAP does exist. In 
addition/ a pointer to the remote LSAP table is placed 
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* 


in the activated LSA? directory of the Local LSAP. 


* INPUT: 

* 

* 


Pointer to mailbox mas sage 
Pointer to layer instance taole 


* OUTPUT: 


*/ 




/* LLC _T RA NS *activate. I sap; * pointer to create local Isap message */ 
/* 

******* NEED TO REVISIT THIS IN ORDER TO SUPPORT ******* 

******* AN ACTIVATE REQUEST FROM A NETWORK LAV £ R ******* 


*/ 
/ * 
/* 
/* 


Cast on activate transaction block message */ 

activate.lsap = (LLC.TRANS *) Jioxotr# * / 

IF layer instance state inoicates lie not registered with 
MAC (state=NULL> */ 

/* THEN */ 


/* Fetch pointer to Isap name in ACTV.MS3 */ 

/* Call search procedure to determine if LSAP exists * / 

/* IF LSAP exists in LSAP directory and LSAP state is Nulled */ 

/♦THEN */ 

/* Call mac.activate procedure to activate MAC layer */ 

/* Re-issue activate message to the llc.mailoox */ 

/* ELSE LSAP doesn't exist */ 

/* Set status of LC8I to indicate oad LSA? */ 

/* Set completion word in the lC3I */ 

/* Request DMA services to transfer LC3 */ 

/* This is one of the difficult errors to handle */ 


/* ENDIF */ 

/* ELSEIF layer instance is in the INUSE state */ 

/* DO CASE on venue to determine 

whetner a remote or local L$A° activate */ 

/* CASE of Local venue ♦/ 

/* case ACTV.LDC: */ 

/* Call orocedure to Activate a Local LSAP for this request */ 
/* Set status of LC3I to indicate operation status */ 

/* CASE of Remote LSAP */ 


t* case ACTV.RMT: */ 

/* Call procedure to Activate a 

Remote LSAP for this request */ 

/* Set status of LC3I to indicate operation status */ 

/* OTHERWISE unknown venue */ 

/* Can this really haopen and not 

be previously detected ? */ 

/* Set status of LC3I to 

indicate bad function specific function code */ 

/* ENDCASE */ 

/* Set completion word in the LC3I */ 

/* activate_lsap->lcbi.blk->cbcbs = LC31.COMPLETED; */ 

/* Request DMA services to transfer LC3 */ 

/* This is one of the difficult errors to handle */ 

/* llcerr.coae = return, lebi < act i vate_ls ap^ li ca_p->Ime.mbx/’ti c a.p) ; */ 
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V.. 

/ * ELSE Layer instance not aole to suoport request * / 

(* Set status of LCSI to indicate Layer unaoLe to supoort reouest */ 
/* Set comoLetion wore in the LC3I */ 

/* acti v ate_lsup-> lcoi_o l k->c be 2 s = LC 31 _Cu^PLET£0 | LCP_ERR; */ 

/* Request D >1A services to transfer L C 3 * / 

/* Tnis is one of the difficult errors to handle */ 

/* llcerr_cooe = return_lcoi(activate_lsap*lica_p->lme.mbx^Lica_p); */ 
/* ENOIF */ 

/* Return */ 

/-* LLc_trn_ac */ 


/ 

I* 

* 

* 

if 

if 

it 

if 

if 

* 

★ 

★ 

* 

* 

k 

* 


**★★*★★★ kk k k ' 


kkkkkkkitkf 


TITLE: 

FUNCTION: 


INPUT: 


OUTPUT: 


ACTIVATE LOCAL L3A? PROCEDURE 


•or a 


Receives an activate LSAP request message 
Local LSAP. 

The request causes a search of the Local LSAP 
directory to insure the LSAP exists and the LSAP 
nas not been previously activated or in a state 
orohioiting service to the user. 

Pointer to mailbox message 
Pointer to Layer instance table 


*/ 


/* Fetch pointer to Lsap name in LC3I */ 

/* Call search procedure to determine if LSAP exists */ 

/ * IF LSAP exists in LSAP directory and LSAP state is Nulled */ 

/* THEN */ 

/•Fetch a pointer to the LSAP table * / 


/ * DO CASE on the major state of the 

/ * CASE OF THE LSAP state is uninitialized ( 

/* SET LSAP TO A »ESAeUS INTERFACE *** 

NEED TO REVISIT FOR NETWORK INTERFACE */ 

/* Set LSAP state to IN-USE and Operational */ 

/* Set logical address into return message or LC3 */ 

/* Set max numoer of bytes in PDU */ 

/* Set read and write creoit values into LC3 */ 

/* Set status to indicate successful operation */ 

/* CASE of LSAP state is already IN-USE */ 

/* Set logical address into return message or LC3 */ 

/* Set max number of bytes in PDU */ 

/* Set read and write credit values into LC3 */ 

/* Set status to indicate SAP is already activated */ 

/* CASE of LSAP is not available for service CLOCKEDx0OWN*etc.) */ 

/* Set status to indicate SAP is unavailable */ /O 

/* SNDCASE */ 

/* ELSE LSAP is non existent */ 

/* Set status to indicate SAP is oaa */ 
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/* END IF 
/* RETURN 
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* / 


/ * *-***»★*•★*★**★'***★★*★★#**★*»★*■*★* *★*★★■**★★*'*★★*★•**★★****/ 
/* 

* TITLE: ACTIVATE REMOTE l.3A 3 PROCEDURE 

★ 


* FUNCTION: 

* 

» 

★ 

* 

ir 

* 

* 

n 

* 

■* 

* 


deceives an activate L3A? request message * 

Activate remote Isap reauests are made with respect 
to a local LSAP. The layer instances local LSAP 
directory is checkeo to insure the local LSA 3 
exists. If it exists then a checx is made on the 
local LSAr activated remote directory to insure that 
the remote h3S not Been already activated. The 
state of the remote USA? is set to Activated if not 
already and a count of the numoer of activates 
received is incremented. Finally a pointer 
to the remote LSAP table is placed 

in the activated LSAP directory of the local LSAP. 


* 

* 




INPUT: 


OUTPUT: 


Pointer to mailsox message 
Pointer to layer instance table 




/* if local Isap address is within dir rang */ 

/* then there is a v3-lid ligical address for the local Isap */ 

/* Fetch 3 pointer to the local LSAP table * 

/* IF L$A° exists in LSAP directory and LSAP state is in INUSE state *7 


/* THEN */ 

/* Fetch pointer to Isao name in LC3I 
/* Call search procedure to determine if 

LSAP already activated for SAP */ 

/* IF Remote lSAP is not activated alreaay for this SAP */ 

/* THEN */ 

/* Search remote SA 3 directory for remote LSAP name */ 
f* IF Isap not defined in directory */ 

/* THEN there is an error */ 

/* Set status to indicate remote 

LSAP are ready activated for this local */ 

/* ElSE Activate remote SAP for this local */ 

/* Set status to indicate successful LC3 */ 

/* Fetch a pointer to the remote LSAP table */ 

/* Call procedure to fetch the next available 
remote LSAP entry */ 

/* Set oointer to remote SAP taole into activate 
of local LSAP taole */ 

/ * Increment count of numoer of activates 
existing for this remote LSAP */ 

/* Set logical address 

into LC3I for the Remote LSAP */ 

/* over write the logical addr long word */ 


*/ 
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/* £ N D I r * / 

/ * ELSE Remote LSAP already activated for this SAP *l 

/* Set logical acoress into LCSI for the Remote s_$AP 
/* Set status to indicate remote LSAP are 
ready activated for this local * / 

/ * £M) I F * / 

/* ELSE Local LSA* not 

availaole for service or nonexistent */ 

/* Set status to indicate 

local LSAP is unavailable or non-existent */ 
/* END I F */ 

/* end first if */ 

/* ELSE Local LSAP not 

availaole for service or nonexistent 
/* Set status to indicate local 

LSAP is unavailable or non-existent */ 

*/ 


/ * Return 
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/ ★ * ★ i 
★ ** * i 


rW**#*****! 


’ * * * * ********** Hr ★ H*H***Hr**i 
r*******************-*************** 


* * * 
** * 

* * T 

* H * 
it ★ * 

* * * 

* it Hr 

* Hr Hr 
Hr * * 
Hr Hr Hr 
Hr * Hr 
Hr Hr * 
It Hr * 
Hr* * 
Hr* * 

* * * 
* ★ * 
*★ * 
*★ Hr 
nr * * 
* * * 

( 

* * * 
*** 
★ * * 
nr * * 
** * 
it* * 

* * nr 
** * 

* ★ it 

* * nr 

* * * 
* * nr 


HIN £ Y WELL 


Local Area Network 

LOGICAL LIN* CONTROL 
LAYER 

megaous interface module 


Copyright: Honeywell Information System 
All rignts reserved. 

Cereate Date: d/25/So 

9y: Lu 

Discriotion: 

Functions i Parameters: 


Revision ft: 
Date: 

By: 

Discription: 

Revision ft: 
Date: 

-5 V * 

J Y * 

Discriotion: 


*/ 



* FUNCTION: 

* 

* 

* 

( 

★ 

* 


Receives an activate LSAP request message * 
local Isap reauest cause a search of the local LSAP 
directory to insure the LSAP exists and the LSAP 
has not oeen previously activated or in a state 
orohibiting service to the user. Remote Isao requests 
are also checked to insure the LSAP does exist. In 
addition* a pointer to the remote LSAP table is olaced 
in the activated LSAP directory of the local LSAP. 
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* 

★ 
tr 

* * * * : 
*/ 


INPUT: 


OUTPUT: 
1 ★ 1 


3 ointer to mailbox massage 
Pointer to layer instance table 


' * ★ Hr 1 


/T 


I 

v ,y 


/* 

******* NEED TO REVISIT THIS IN 0R0E9 TO SUPPORT ******* 

******* AN ACTIVATE REQUEST FROM A NETWORK LAYER ******* 

*/ 

/ * Cast on activate transaction block message */ 

/* IF layer instance state indicates lie not 

registered with MAC (state=N'JLL) */ 

/* THEN */ 


/* Fetcn pointer to Isao name in LC3I */ 

f* Call search procedure to determine if lSAP exists */ 

I* IF LSAP exists in LSAP directory ana LSA® state is Nulled */ 

/* THEN */ 

/* Call mac_activate procedure to activate MAC layer */ 

/* Re-issue activate message to the llc.mailbox */ 

/* ELSE LSAP doesn't exist */ 

/* Set status of LC3I to indicate bad LSAP */ 

/* Set completion word in the LCBI */ 

/* Request DMA services to transfer LC3 */ 


/* This is one of the difficult errors to nanole */ 

/* ENDIF */ 

> /* if */ 

/* ELSEIF layer instance is in the INUSE state */ 

/* DO CASE on venue to determine whether a 

remote or local LSAP activate */ 

/■* CASE of Local venue */ 

/* Call procedure to Activate a Local LSAP for this request */ 

/* Set completion word in the LC3I */ 

/* Set status of LCSI to indicate 

layer unable to support request */ 

/* Request DMA services to transfer LCE */ 

/ * This is one of the difficult errors to handle */ 

/* Set status of LC5I to indicate operation status */ 


/* CASE of Remote LSAP 

/* Call procedure to Activate a Remote LSAP for this request 


★ / 

★/ ^ 


/* set status of LC3I to indicate operation status */ 
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/* DTHc^UIS: unknown venue */ 

/* Can this really nacpen and net be 

oreviously detected ? * / 

/ * Set status c‘ LCSI to indicate caa 

function soecific function code */ 

/ * £ N OCASc * / 

/* Set comoletion word in the LCSI */ 

/* Request DMA services to transfer lC3 */ 

/* This is one of the difficult errors to handle */ 

/* ELSE layer instance not able to support request */ 

/* Set status of LCSI to indicate layer unaole to support request */ 

/* Set completion word in the LC8I */ 

/* Request DMA services to transfer LCd */ 

/* Tnis is one of the difficult errors to handle */ 


/* END IF 


*/ 


/* Return 

> /* llc_lme_ac */ 


*/ 



/* 


* 


* TITLE: 

* 

* FUNCTION: 
*• 

* 

* 

* 

* 


ACTIVATE LOCAL LSAP PROCEDURE 

Receives an activate s-SA^ 3 request message for a 
local LSAP. 

The request causes a search of the local LSAP 
directory to insure the LSAP exists ana the LSAP 
has not been previously activated or in a state 
orohibiting service to the user. 


* INPUT: Pointer to mailbox message 

* Pointer to layer instance taole 

* 

* OUTPUT: 


* / 


/* Fetch pointer to Isap name in LC3I * / 

/* Call search procedure to determine if LSAP exists */ 

/* IF LSAP exists in LSAP directory and LSAP state is Nulled */ 

/* THEN */ 

/* Fetch a pointer to the LSAP table W 



/* DO CASE on the major state of the LSAP to determine 

actions required */ 
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/ * CASE OF THE lSAP state is uininitializea 

(L$A P major state is null) */ 

/* SET LSAP TO A McSA^US INTERFACE *** 

MEED TO REVISIT FOR NETWORK INTERFACE */ 

/* Set LSA? state to IN-USE and Operational */ 

/ * Set logical address into return message or -LCB */ 

/* Set max number of oytes in PDU */ 

/ * Set reaa and write credit values into LCB */ 

/* Set status to indicate successful operation */ 

/* CASE of LSAP state is already IN-USE */ 

/* Set logical aodress into return message or LCB */ 

/* Set max number of oytes in POU */ 

/* Set read and write credit values into LCB */ 

/* Set status to inoicate SAP is alreaay activated */ 

/* CASE of LSAP is not available for service (LQCKEO/DOWIWetc.) */ 

/* Set status to indicate SAP is unavailaole 
/ * ENOCASE */ 

/* ELSE LSAP is non existent */ 

/* Set status to indicate SAP is oad */ 

/* END IF 

/* RETURN */ 

> /* act_l_Isao *7 


/* 

* TITLE: 


ACTIVATE REMOTE LSAP PROCEDURE 


FUNCTION: 


INPUT: 


Receives an activate LSAP request message r 
Activate remote Isap requests are made with respect 
to a local LSAP. The layer instances local LSAP 
directory is checkec to insure the local LSAP 
exists. If it exists then a check is made on the 
local LSAP activated remote directory to insure that 
the remote has not been already activated. The 
state of the remote LSAP is set to Activated if not 
already and a count of the number of activates 
received is incremented. Finally a pointer 
to the remote LSAP table is olaced 

in tne activated LSAP directory of the local LSAP. 

Pointer to mailbox message 
Pointer to layer instance table 


OUTPUT: 




iej 19 09: ji 1 *s<> /jsp/-3vlp/llc.o^l/llc m e 9 a . c . 0 j l J aie 5 

( 


•**★★*★**★«’*****★« n Hr ♦ ★ * Hr : 




*/ 


/ * if local l s a o a a 3 r 3 s s is w i t h i n cir ran,; * / 

/* then there is a valid l i g i c a l actress for the Local l s a 0 */ 
/* Fetch 3 aointer to the local LSA 3 taol? 


★ / 


/* IF LSAP exists in lSAP cirectory and LSAP state is in I MUSE 
/* THEN */ 

/« Fetch pointer to Isap name in LC31 
/* Call search orocedjre to determine if 
LSAP already activated for SAP */ 

/ * Search remote SAP directory for remote L S A 3 name 
/ * If Isap not defined in directory 

/•THEN there is an error */ 

/* Set status to indicate remote 
/* ELSE Activate remote SA° for tnis local */ 

/ * Set status to indicate successful L C 3 


state * / 
*/ 


*/ 

*/ 


*/ 


/* fetch 3 pointer to the remote LSAP taole * / 
/* Call procedure to fetch the next 
/* Set pointer to remote SAP 
/ * Increment count of number of 



/* 


/ * Set logical address 

into LCSI for the demote LSAP 
ELSE Remote LSAP already activated 


*/ 

for this SAP */ 


/* Set logical address into LCSI for the Remote LSA 3 */ 

/* Set status to indicate remote 

LSAP are ready activated for this local */ 

/* END If */ 

> /* if */ 

/* ELSE Local LSAP not availaole for service or nonexistent */ 
/* Set status tc indicate local 

LSAP is unavailaole or non-existent */ 


/* ENDIF */ 

/* end first if */ 

/* ELSE Local LSAP not available for service or nonexistent */ 

/* Set status to indicate local LSAP is unavailaole or non-existent */ 
/♦Return * / 

> /* act rtsao */ 


/*---—— 

/* The request to 

TITLE: 



---f"egaous Interface —--— - - 

PMA a LCSI from the L6 to the LACS has returned */ 

SEND DATA PUFFER TO LG PROCEDURE 


*/ 


★ 


FUNCTION: 


This routine requests the DMA services to transfer 




S eo 19 09:04 1 93o /jsr/dvlp/llc_odl/llc_mega.c.ool 


* 

★ 

★ 


* / 


3 data buffer to L6 memory. Data can 
5 ways: in the L C 3 itself* to buffer 
tn? lC hr cr into buffers soecifed oy 


/T~ 

K 

be transfered in 
descrioed by 
a buffer descriptor 


* 


pointed 

t 0 

oy 

the LC3. 


INPUT: 

Rci n t er 

t 0 

MAC 

oata indicate message 

* 


Pointer 

to 

the 

LC3I transaction block 

★ 

* 

* 

OUTPUT: 

pointer 

to 

the 

layer instance table 


•**★★** ★ * nr 


* This message has been returned from DMA services. The *ollcwinq 

* code will chec< the results of the transfer request and if it was 

* successful. 

***’it**it*** , *ifc*'**"*************ilr***tt*ilr*********^ 

* / 


/* DO 

CASE 

on 

the 

tyoe of 

data buffer 

in LC3I */ 


/* 

CASE 

o f 

data 

buffer 

contained in the LCS */ 




/*da t a 

in Icb* 

data buffer 

transfer */ 




/* 

for 

call rev 

_fcu f _t o_ 16 

no ooolem set */ 




/* 

set 

the read 

credit count for leb user flow 

control */ 



/* 

set 

remote logical address */ 




/* 

Set 

the LC 31 

completion 

oit 

*/ 



/ * 

get 

correct 

puffer and 

return * / 



/* CASE of data buffer pointer(s) contained in the LCoI * / 

/• Request the buffer be transferred to the Lb */ 

/* Have the message return to tne DMA done mailbox */ 

/* Set priority to normal */ 

/* Set the number of L6 ouffers */ 

/ * Set a residual range pointer to point to 
puffer C residual range */ 

/* Initiailize total range to pdu minus lie header */ 

/* DO FOR all buffers in the LC3I 

/* Set the Lb buffer descriotors */ 

/* Set the L6 buffer range */ 


*/ 
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/ * 
* 

* 

nr 

* 

* 

* i 
*/ 


*★★★*■** tr-kicitltitlritltl* *■***+*** 

Thera is a problem if tn? t o t 3 l r a n .3 e excseas j2K words 

fortunately _LC will always be less 3U' r 
DC WE NEED TO VALIDATE RANGE and 
WHAT AiOJT LC3 FORMAT ? (p?'pr Ip oits) 
and WHAT A 3 OUT LC H FORMAT - short now 

/* Set the resiou 3 l range and uodate total range */ 

/ * IF the total range is equal to zero * / 


/* THEN set residual range to 

eqjal the whole ouffer */ 
/* *rsr_ptr */ 


/ * ELSE IF total range is less than the buffer * / 

/ * THEN set residual range equal 

to buffer minus the total range */ 

/* Set the total range to zero*/ 


/* ELSE resiaual range is zero */ 

/* *rsr_ptr = CJ* set residual range to zero*/ 

/* Set the total range minus the buffer size */ 



/* Decrement the resiaual range 

30 inter to point to the next */ 

/* ENDDO */ 

/ * Set ouffer from llc_ttrans block into dma message */ 
/* Clear channel and interrupt level */ 


/* Clear all remaining fields */ 

/* Send the request message to DMA services */ 

/ * special rojtine for llc_trans release * / 

> /* else if full*/ 


/* CASE of a buffer descriptor pointer contained in the LC3I */ 
/* Set invalid status in the LC3I */ 

/* set the read credit count for tco user flow control */ 

/* Set the LC2I comoletion bit */ 

/•Return the LC3I to L 6 memory*/ 

/* OTHERWISE */ 



* Can not decode the ouffer type into anything 

* that can oe processed by this function. Update the LC3I 

* status to reflect the problem anc return the LC31 to 

* the L 6 . 
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*/ 


/ * Set invalid status in the LC3I * / 

/» set the reaa credit count for Leo user flow contro 

/* Set the LC •? I completion Pit 
/* Return the LC3I to L5 memory */ 


/* ENDCASi W 
> / * switch */ 

/* send_auf_to_lo */ 


> 
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Revision tti 
Date: 

3y: 
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Date: 
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Discription: 




/it it i 


This module is using for deougging software creak point 
set uo and othe tool for deougging. the entire module 
and the relatea deougging statements in the lie layer 
codes should all taxe out. 


I believe this is tne more efficient way to develop 
software. I t will oe proved. 


★ it 
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* * 
k * 

* * 

★ * it it 
*/ 


k it It it it it 


/ it it it It *m 
it it 


■kkkkkkkkkk 1 


kkkkkkkkkk tekltkkk 


** Software (C) areak points rount? 

* ★ 

★ * 


*/ 


★ * 

** orint L3C rounte 

** 


w it 


it k i 


*/ 



**★* 


** 


* * 

** print EC3 rounte 

** 


•k it 


*/ 


kit 


it it 

** print message rounte 

★ ★ 
kit 


*/ 
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( 


* * * * * * * i 


'♦fc*******^** ******** ******** 


*/ 


/ * i 
nr * 

★ * 

★ * 

*★ 

♦ * 
****<. 
* / 


** * * ** * * i 


:******************** 


print startup parameters rounte 



o d l 3 age 1 
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★ ★ ★ 
★ ★ ★ 
★ ★ * 

★ Hr ★ 

★ ★ ★ 

★ Hr ★ 

★ ★ ★ 
★ ★ ★ 
★ ★ * 
★ ★ ★ 
★ ★ ★ 
★ ★ ★ 


L O G I 


HONEYwELL 

Local Area Network 
C AL LINK CONTROL 
LAYER 
common module 


★ ★ ★ 

*** Copyright: Honeywell Information System 

* * * All rights reserved. 

★ ★ ★ 

*** Cereate Date: 1/25/35 

*** 3y: 0. Oshaughn 

*** Oiscriotion: 

** ★ 

*** Functions 1 Parameters: 

★ ★ ★ 


★ ■★ tr 

** * Re vision#: 1 

*** Date: 3/25/56 

*** 3y: Lu 

*** Oiscriotion: 

★ ★ ★ 

★ * * Revision #: 

★★★ Date: 

★ ★ ★ 3y : 

*** Discription: 

★ ★ ★ 


★ ★ ★ 



*/ 


/* - —---LLC SAP Component------ */ 

* A procedure to return a *not active* status in tne LC3I that has 

* just Deen transferee and tne LSAP was not active. 

* 

* The parameter is a pointer tc the lie transaction. 

★ 

* FUNCTIONS list: 

* 

* lsao.not_active (11c.trans) 

* LLC_TRANS *llc_trans/ * A pointer to the lie transaction * 

* IOLDs(maxptr/•ret_mdx/lica_p> 






k 

k 


k 


k 

★ 

* 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 

k 
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*53 *moxotr; 

MalD ret.mox; * Tne return nailcox ID * 
i-ICA *lica_p; * P 3 inter to the process variables * 
retjrn_lcoi(llc_trans/ret_mbx/lica_3) 
lLC_TRA.\S *llc_trans; 

*•3 ID return ox/ * The return mailocx ID * 
i-ICA * l i c a _ p; 

r eturn^ouf f ((. lc_t r ans/ li c a _ o) 

LLC_TRANS *llc_trans; 

LICA *lica_p; 
lcbi_to_lo(:nbxotr/lica_o) 

MSG *moxpt r; 

lICA *lica_p; * Pointer to the process variables * 
buf_to_lac(mbxptr/lica_o) 

MSS «mbxptr; 

LICA *lica_p; 
buf_to_l 6 (mpxptr/lica_p> 

MSS *fnoxotr; 

LICA *lica_p; 

snort llc_aldrm(mem_btk/ms 3 _type/alrm_per) 

AMS 6 *mem_blk; * Pointer to the memory block * 
ushort msg.type; * LLC message type * 
u_long airm_per; * Alarm period * 



/* A pointer to the lie transaction */ 

/* Kernel return cooes */ 

/* Set the status for LSAP not active */ 
/* lsaa_not_active */ 


/* - Megabus Interface - 

/* An I OLD request message */ 

/* This message is from the megaous interface software and states */ 
/ * 

* TITLE: RECEIVE I0LD MESSAGE and REQUEST LC3I FORM Lo PROCEDURE 


*/ 

*/ 


* 

* 


* 

* 

* 

* 

* 

★ 



* 


FUNCTION: 

An IOLD command W 3 S issued oy the Lb for this board and instance. 
All function specific function codes for the LLC layer 
and instance are all routed here at sign-in time. The object of this 
code is to find space for the LC3I and request DMA services to make 
the transfer across the megaous. The message wilt oe returned when 
DMA services completes the transfer or finds a reason why the step 
cannot oe performed. 

A LLC cransation block is used from this point on to process requests. 
The too end of the olock is a union of message types used to DMA the 
LC3X/ to DMA any buffers involved/ and to request L_DATA.request. The 
instance/ the LSAP taole/ ana the LC3I alt have oointers to them carried 
along with the transaction block. 
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tr 

* 

k 

Ik 

* 

* 


Input: 3 ointer to IOLO message 

Return m a i l a a x ia 

Access to common system management data structures 
Output: Error Status 


*/ 


/* The return mailaox ID */ 

/ * Pointer to the process variaoles */ 

/* Pointer to tne LLC transaction block */ 

/* Kernel error codes */ 

/* clear block pointer */ 

/* clear block counter */ 

/* Get some space for a LLC transaction */ 

/ * return to the calling * / 

/* if £RP_P£TUPN */ 

/* initial all null */ 

/* Set the size of the transfer per the I0LD request */ 
/* Save the length for the return trip later */ 


/* Save the channel aits for the return trip */ 


/* Get and save the pointer to a memory olock 
tne size requested plus queue pointers */ 


/* IF no space is available */ 

/* return to the callinq */ 
/* if ERq_.tETLRN */ 

/* END IF */ 

/* clean up all mem llc_trans”>lcbi_olk */ 

/* Point to the LC3I block */ 

/* Have the message return to the supplied mailoox */ 

/* Set request type to ’move LC3 to LACS' */ 

/* Set the La address from tne IOLD request */ 

/* Save the L6 address for tne return trip later */ 

/* Copy channel and level information */ 

/* Set priority to normal */ 

/* Clear all remaining fields ★/ 


zf \ 
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( 

/ * Send the re guest message to DMA */ 


/* return to tne calling •/ 
/* if ERR^RETURN */ 


/* 

/* 

Free the 
An ERROR 

I0LD 

CODE 

request 

SHOULD 

message clock 
HE PART OF THE 

*/ 

RETURN 

*/ 

/* 

RETurn 
/* IOld s 

*/ 




*/ 


* 

* 

* 

★ 

* 

★ 

★ 

ie 

i 


/ 

/*-*-——----Megabus Interface —--——■ 

/* A common function to return LC3I blocks across the megaous */ 
/* 

TITLE; RETURN LC3I T3 L6 PROCEDURE 


FUNCTION: This function receives a transaction clock containing a 
a LC 31. It creates amessage to for the software to return it 

to L6 memory . The LC 31 status must have oeen set oy the caller 

Input: Pointer to transaction block 

Return mai Ibox io 

Access to common system management data structures 
Output: Error Status 


*/ 

★ / 


*/ 


/* 



The return mailoox ID */ 

/* Kernel error return code */ 

/* Convert the message into a DMA LC 31 request */ 

/* Have the message return to the D*A done mailbox 

/* Set priority to normal */ 

/* Point to the LC3I to oe transfered */ 

/* Declare the length to be transferred */ 

/* Move the L6 memory address to the DMA request */ 

/* Copy CPU^ channels and level from LCBI */ 

/* Clear all remaining fields */ 

/* set error detection bit for level 6 software */ 
/* Seno the request message to DMA services */ 


*/ 
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V 

/« return to tne calling * / 

/ * if ERRRETURN * / 


/* Return 

/* retjrn_lcoi */ 


*/ 


/ * * ★ i 


/* —--— ---Megaous Interface --—-—- */ 

/* 


+ A common procedure to return message puffers to the L6 memory. 

* The parameters passed are: the LLC transaction/ the indication message/ 

* and the variables for LLC. 


*/ 


/ * Kernel return codes */ 


/* Convert the lie transaction into a suffer DMA request */ 


/* Have the message return to tne DMA dene mailbox */ 

/* Set priority to normal */ 

/* Set the Duffer count to 1.. Note: Tnere may be more in the future. */ 

/* Set the L6 ouffer descriptors */ 

/* Set tne L6 ouffer range */ 

/ * Copy CPU/ channel/ and level from LC3I */ 

/* Clear all remaining fields •/ 

/* Send the reauest message to DMA services */ 

/* return to the calling */ 

/* if ERR.RETURN */ 

/* return_puf */ 


/ * ** 

/*-----Megaous Interface- 

/* The request to DMA a L3CI to the Lc Has returned */ 

/ * 


*/ 


* 

* 

* 

* 

* 

* 

* 

* 

* 

* 


TITLE: 


FUNCTION: 


LC3I TRANSFER TO L6 COMPLETED PROCEDURE 
A receive / xmit or Ime 

LC3 data request has been completed and 
the L6 memory LC3 has oeen uocated by the LACS DMA. 
This routine releases the LACS memory for the LC9I/ 
for the transaction olock/ and the buffer descriptor 
olock (if there is one)/ for the data buffer(if there 
is one)/ and a mac data indicate message(if there is 
one). 


,4 , 
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/usr/dvlo/llc_odl/llc_common 


oal Page 6 


:»eo 

( 

* 

* IN^UT: 

w 

* 

* OUTPUT; 


Pointer to LLC transaction block 
Pointer to layer instance taole 

Error Cole 


***★******#■** 1 * * ★ ★ 1 


ft***********! 


■ it it if it it 


*/ 


/* 


Pointer to the orocess variaoles * / 


* This message is oeing returnee by DMA services after LLC has mace 

* a request to transfer a lC 3 back to the Lo. The following code will 

* cneck the results of the request and free the message if all went well. 


*/ 


/* Pointer to the LLC transaction block */ 


/* IF the transfer was successful */ 

/* ELSE */ 

/* Decide what to do witn DMA failures at this point..*/ 
/* ENDIF */ 

/* lcbi_to_l6 */ 


c 


/ * 

It 

* 

» 

* 

it 

* 

* 

* 

It 

It 

It 

It 


TITLE; 

FUNCTION; 


INPUT; 

OUTPUT; 


CLEAN LLC.TRANS 3L3CK FUNCTION 
A receive / xmit or Ime 

This routine releases the LACS memory for the LC3I/ 
for the transaction dock/' and the buffer descriptor 
olock (if there is one)/ for the data ouffer(if there 
is one)/ ana a mac data inaicate messageCif there is 
one) . 

Pointer to LLC transaction block 
Error Code 



/ * Pointer to the trans oloex */ 


/* 



* IF the transaction block points to service block not NULL * 

* THEN release the serv * 

* END If * 

/* If the transaction olock points to mac data indicate message 
/ * THEN release the mac indicate message */ 

/* END IF */ 


*/ 
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/ * 

If the transaction 

olocx points to data puffer 



/* THEN release 

tne data buffer 

«/ 

9 * 

ENDIF 


*/ 

/ * 

If the LC31 points 
/ * THEN release 

to lebi */ 
the lebi */ 


/* 

ENDIF 


*/ 

/* 

IF the LC31 ooints 
/ * THEN release 

to buffer descriptor 
the ouffer descriptor 

*/ 


/* ENDIF */ 

/* Release the LlC transaction block */ 

/* trans clr */ 


/» -Mega pus Interface - */ 

/* The request to DMA a Duffer from the Lo has returns a */ 


r * * * *r ★ ! 


/* Pointer to the l_pdu */ 
/* Array index */ 


* This message is returned oy DMA services when it completes the 

* transfer of a ouffer from tne L6 to the LACS ooard 3S part of a 

* transmit transaction. This step will add the LLC layer* addressing 

* to the message and send the Ipd.u to MAC for transmission. 


*/ 


f* Pointer to the LlC transaction block */ 
/* Kernel return codes */ 



/* IF the transfer was a success */ 

/* Change the transaction into a L _ D A T A .request */ 

/* Send to the LLC layer */ 

/* ELSE */ 

/* Report a DMA failure */ 

/* Set the LC3 status to completed */ 


/* 


/* Return the LC9I to L6 memory */ 
ENDIF */ 

/* buf_to_lac */ 


/* —- 
/* The 

/ * ** l 


request to DMA a buffer 


■ Megabus Interface —■ 
to the Lb has returned */ 


* / 


/r 

V, 


* This message is returned by DMA services when it completes tne 







( 
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* transfer of a puffer froir the LACS board to the L6 as part of a read 

* transaction. This step will set the status in the L C 51 and request A 
♦services to return the LCs. to tneL 6. 


’***★*★*’**★ kit ' 


k it it it it it 


- Hr it ir it it 1 


r it ★ it ★ Hr tr k 


♦ / 


/* Pointer to the LLC transaction block */ 
/* Kernel return code */ 

/ * Indicate LC3I comoletion in the status */ 

/* Return the LC3X to L6 memory */ 

> /* Duf_to_l6 */ 

/* End of LLC procedures */ 


/* - LLC Layer Management-----♦ / 

/ * 


it 

it 


it 

it 


c: 


Tnis function will request an alarm from the Kernel via a 
message. The caller must supply a olock of memory the size of 
the alarm message (AMSS)/ the message type for the returning 
message* and the period to wait before the alarm message is 
returned via the process default mailbox. 


/* Pointer to tne memory block * / 

/* LLC message type */ - 

f * Alarm period */ 

/* Set the priority and clear the buffer descriotors */ 
/* Set the message type to aging alarm */ 

/» Set length of timeout interval in seconds */ 


/♦ Reouest the next 


aging alarm period * / 



7* lie alarm */ 
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★ ★ it 

★ Hr ★ 


★ *r nr 

★ * * HQNcYWtLL 

★ ★ ★ 

*** Local Area Network 

Hr Hr ★ 

★ ★* LOGICAL LINK CONTROL 

★ ★ Hr 

* Hr Hr L A Y £ R 

Hr Hr Hr 

*** event message module 

* * * 

★ nr Hr 

«* * Copyright: Honeywell Information System 

*** All rights reserved. 

** * 

*** Cereate Date: 3/5/36 

*** 3y: M. Lu 

*** Discriotion: 

*** 

*** Functions & Parameters: 

nr Hr Hr 
*★ Hr 

*** Revision 4: 

**« Pate: 

** * 3y: 

*** Discriotion: 

★ Hr nr 

*** Revision A: 

** * Date: 

** * 3y: 

*** Discriotion: 

** * 

★ ★ ★ 



*/ 


/*----—--LLC Layer Management - 

/ * A LLC Layer management event message */ 

/* 


« FUNCTION 

* Handling all error and crash situations. 

* It will eventually grow up to a large complicate 

* module. 

* The event message recieved by the lie layer management 

* mooule is of the format* 

* __ layer info 

* _ layer inst 
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layer inter, selector 
event status 


I'jPjT: pointer to event message aoox. 

pointer to layer instance t a o t e . 

OUTPUT: 


/* all function moved to common event.msg routine */ 
/* ptr to event msg */ 
f* iteration index */ 

/* return code */ 

f* clear clock pointer */ 

/ * clock size */ 

/ * clear olock counter */ 


/* allocate space for event msg*/ 

/* return to tne calling */ 

/* if ERR.RET'uRN */ ' 

/ * if * / 

/* clean up all mem msgptr */ 

/* set up event msg */ 

/ * load layer internal selector para.ms from llc.trans 
into event msg */ 

/* for */ 

/* for */ 


/* set uo event status */ 


/* OR error class with soecificevent code to get event code */ 

/* send event msg to SM — use event mailbox Ii> in LLC.T RA N S 
if error/ call mexit */ 


/* return to the calling */ 
/* if ERR.RETURN */ 

/* if */ 

/ * else */ 

/* llc.ev.msg */ 


/* Error status */ 

Isao index */ 

/« An event reauest nas been received via LLC layer management'. */ 
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/* get tne l_sao_taole atr */ 

7* validate Isa? taole * / 

/ * oull the local l_lsac_ta?le address */ 

/* cut the event L C a olo c k to tne Isao taole «/ 

/ * if */ 

/* return not valid I c o error * / 

/* completed with error */ 

/* return tne bad leb */ 

/* get out here */ 

/ * else */ 

/* the common event_msg routine will handle tne event LC3 return */ 
/* llc_lme_ev */ 

/ * Pointer to activate LSAP message */ 

/* Pointer to the instance table */ 

/* pointer to event transaction olock message */ 

/* Index of remote SAP directory */ 

/* LLC error status */ 

/* pointer to ls3D name */ 

/* 

******* need TO REVISIT THIS IN ORDER TO SUPPORT ******* 

******* AN EVENT MESSAGE FROM A NETWORK LAYER ******* 

*/ 

/* An event request has seen received via LLC layer management- */ 
/* Cast on event transaction block message */ 

/* Set comoletion word in the LCSI 

/* Request DMA services to transfer lC3 */ 

/* This is one of the difficult errors to handle */ 

/* return to the calling */ 

/* i f £PR_R E TURN */ 

/* IF layer instance state indicates 

lie not registered witn MAC (state=NJLL) */ 

/* THEN 

/* Fetch pointer to Isap name in LC9I 

/* Call search procedure to determine if L3A® exists 

/* IF LSAP exists in LSAP directory and LSAP state is Nulled 

/* THEN */ 

/* Call mac_activate procedure to activate MAC layer 
/* Re-issue event message to the llc_mailfcox 
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/* 

if 

/ * return tc 
ERR.RETLRN */ 

the 

calling 

*/ 

/* 

i T 

/ * return to 
£9R_RETURN */ 

the 

calling 

*/ 

/* 

i f 

/* return to 
ERR RETURN */ 

t he 

calling 

*/ 


/* ELSE LSAP doesn't exist 


*/ 


/* Set status of LC3 I to indicate Pad LSAP */ 

/ * Set completion word in the LC 31 */ 

/* Request 0,1 A services to transfer ICd */ 

/* This is one of the difficult errors to handle */ 


/* return to the calling */ 

/* if ERR.RETIHN */ 

/* ENDIF */ 

/* tLSEI F layer instance is in the INU3E state */ 

/* DO CASE on venue to determine whether a */ 

/* Set completion woro in the LC3I */ 

/* Request DMA services to transfer LC5 */ 

/* This is one of the difficult errors to handle */ 

/* return to the calling */ 

/* if ERR_RE TURN */ 

/* ELSE layer instance not aole to suoport request */ 

/* Set status of LCBI to indicate layer unable to support request */ 

/♦Set completion word in the LC31 */ 

/* Request DMA services to transfer LC3 */ 

/* This is one of the difficult errors to handte */ 

/* return to the calling */ 

/* if ERR RETURN */ 


*/ 

*/ 


/* ENDIF 
/* Return 

/* llc_lme_ev */ 
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Hr**Hr****HrHrHr**WHrHr***Hr***HrirHrHr*Hr*HrHtHr*HrirHr**Hr*ilrHr*HrHrHrHrHr*HrHrHrHrHrRrHrHr*HrHr*HrHrir 
Hrtr * 

Hr Hr Hr 

* Hr Hr 

*** HOMEY WELL 

Hr *• Hr 

*** Local Area Network 

* ★ Hr 

*** LOGICAL LINK CONTROL 

nr* Hr 

*** LAYER 

* * Hr 

*** error handling module 

Hr * Hr 
Hr Hr Hr 

*** Copyright: Honeywell Information System 

*** All rignts reserved. 

Hr Hr * 

* * * Cere ate Date; 3/25/86 

By: r« Lu 

*** Discription: 

Hr tt Hr 

**« Functions 4 Parameters: 

«** llc.errCerrcode/’errmsg^err.trans) 

*** short errcode; 

***• char *errmsg; 

*** LLC.TRANS *err.trans# 

*** error cases: 

*** case SAP_NGT_AVAILA9LE: 

*** case 34D_FSFC: 

*★« case SAD_LAY€R_STATE: 

*■** case 3AD_R£M0T£ _ 3 A° : 

*** case 3AB_L0CAL_$AP: 

*** case INVALID.FC: 

*** case SAP.ACTIVE: 

*** case MULTIPLE.ACT: 

*** case 3AD_R_LSA?_STATE: 

*** case 3AD_L.L5AP_STAT£: 

*** case 3A0_BUFF.TRAN: 

*** case 3AD_3DI„,TRAN; 

*** case SAD_XMIT_REQ: 

*** case 3AD_PDU_SIZt: 

*** case SUFF.TOO.SMALL: 

*** case 3AD_03AP_STATE: 

*** case 3AD_RCV_DSAP: 

«** case 8AD_RCV_S$AP: 

.*** case PDli_TOC_BIG: 

*** case 6A0_RCV_REQ: 

*** case XID.XMIT.ERR: 

*** case XID_R£SP_£RR: 

case UNKN MSG 


Hr* * 


0x0024 * unknown message tyoe * 
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>_S;M_RMiCX 

.RM20X_FU 

, M £ M _ -3 c T 
^EM^ALD 

.lC.ii_er.r 
>_D"!A_M 3GX 
k~M30X_ FU 
>~L C 3 I_ RP 
k 8JF FAIL 


de fault 


Revision #: 
Sate: 

3y: 

Discriotion: 

Revision 4z 
Date: 

3y: 

Discript ion: 


JxOC 25 * invalid return mail oox 

0x3026 * S v return mailoox full * 

0x0027 * invalid 5 . v , request * 

0x002c * getauf could not allocate 

j x j 0 2 > * allocate no mem avail * 

0x 0C 3 C * return Icoi error * 
jx 0C31 * invalid DMA mail aox * 
0x0032 * DMA return mailbox full * 

0x3033 * bad Icoi response - big eri 

0x0035 * DMA of a buffer failed * 




/* counters */ 

/* event code for event msg */ 

/♦get layer instance table*/ 

/ * pointer at the ring for last message */ 

/* ERfi_MSG_CCUVT in the error message ring */ 

/* ring counter */ 

/ * save error message «/ 

/* pointer at the ring for last message */ 

/* ERR_MSG_C0UNT in the error message ring */ 

/* ring counter */ 

/ * save the err data block pointer address */ 

/* save the lica.p */ 

/* LLC layer error condition case 3A?_MGf_AVAILAoLc*/ 

/* LLC layer error condition case 3AD..FSCF */ 

/* LLC layer error condition case 6AD_LAYER..STAT E */ 

/* LLC layer error condition case 3AD - RE V I0TS_SAP */ 



/* LLC layer error condition case 3AD_LCCAL_SAP */ 

/* LLC layer error condition case INVALID_FC */ 


/ * LLC layer error condition case 


3AP_ACTIVE »/ 
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/ * 

LLC 

layer 

error 

condition 

case 

MULTI°Lc_ACT */ 


/ * 

LLC 

layer 

error 

conoition 

case 

3AD_R_LSA^$TATE 

*/ 

/* 

LLC 

laye* - 

error 

conoition 

case 

3AD_L_LSA?_STATE 

*/ 


LLC 

layer 

error 

condition 

case 

3AD_3UFF_TRAN */ 


/ * 

LLC 

layer 

error 

conoition 

case 

8AD_3DI_TRAN */ 


/* 

LLC 

13 yer 

error 

conoition 

case 

5AD_XMIT_REu */ 


/* 

LLC 

l ayer 

error 

conoition 

case 

3AD_PDU_3IZ£ */ 


/« 

LLC 

layer 

error 

condition 

case 

3UF_T0C.SMALL */ 



/* LLC layer error concition case 3AD_DSA?_STATE */ 


/* LLC layer error concition case 3AD_RCtf_DSAP */ 

/* LLC layer error condition case 3AD_RCV_3SAP */ 

/* LLC layer error condition case PDU_TC0_3IG */ 

/* LLC layer error condition case 5A0_RCV_PEJ */ 

/ * LLC layer error condition case XID_XMIT_ERR * / 

/* LLC layer error condition case XID_R£SP_ERR * / 

/* LLC layer error condition case */ 

/* LLC layer error condition case 3AD_$M_RM30X */ 

/* invalid 3M return mail oox */ 

/* LLC layer error condition case SM_RM3CX_FU */ 

/* SI return mailoox full */ 

/* LLC layer error condition case 3AD_SM_R£a */ 

/* invalid $M request */ 

/* LLC layer error condition case N0_M£M_3ET */ 

/* getouf could not allocate */ 

/* LLC layer error condition case NO_MEM_ALO «/ 

/* allocate no mem availible */ 

/* LLC layer error condition case RT_LC3I_£RR */ 

/* return Icoi error */ 


/* LLC layer error condition case 
/* invalid DMA mail box */ 


SAD DMA MSOX */ 
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* .. 

/ * 

LLC 

Layer 
/* DMA 

error conaition 
return Dailco< 

case 

«ull 

9MA.M30X.FU */ 

*/ 

/ * 

ll: 

layer error 
/* invalid M 

condition case 
AC mail oox */ 

SA0.MAC.M30X */ 

/* 

LLC 

layer 
/* MAC 

error condition 
return mailoox 

case 

full 

KAC.M30X.FU */ 

*/ 

/ * 

LL C 

lay er 
/ * bad 

error 

lebi 

condition 
resDonse - 

case 

big 

3AD.LC3I.R? */ 

err *f 

/ * 
/* 

LLC 

data 

layer error 
too long to 

conoition 
put in lco 

case 

*/ 

TOO.LONG.DLC3 */ 

/ * 

/* DMA of * 

LLC layer error 
duffer failed */ 

condition 

case 

DAM.3U F.FAIL */ 

/* 
/ * 

LLC 

LLC 

layer 

layer 

error 

error 

c oncition 
conaition 

case 

case 

3AD.R;30LVE_M30X */ 

5AD.REG.MaOX */ 

/* 

LLC 

layer 

error 

condition 

case 

M30X.0N.ERR */ 

/ * 

| 

LLC 

layer 

error 

conoition 

case 

M3CX.0FF.cRR */ 

' /* 

LLC 

layer 

error 

conaition 

case 

M3CX_0L_6RR */ 

/ * 

LLC 

layer 

error 

condition 

case 

SENDMSG.cRR »/ 

/* 

LcC 

layer 

error 

condition 

case 

3AD.I0.M3G */ 

/* 

LLC 

layer 

error 

conaition 

case 

SAD.REG.MuXDIR */ 

/* 

LLC 

layer 

error 

conaitio n 

case 

INV.T RANSr */ 

/* 

LLC 

layer 

error 

c onaition 

case 

QUEUE.FULL */ 

/ * 

LLC 

layer 

error 

conaition 

case 

DEFAULT.ERR */ 

/* 

LLC 

layer 

error 

condition 

case 

-1 */ 

/* 

LLC 

layer 

error 

condition 

case 

1 */ 

/ * 

LLC 

layer 

error 

condition 

case 

0 */ 

/<* switch */ 





/*llc.event.cd = EVENT.INDIC; 

/* event indicate mssage */ 

/* send event message to system 

f'- 

* event indicate mssage */ 

management */ 

* /* end 

lie 

.err */ 





/* central 

handling for exit 

c onoition 

*/ 
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/* kernel call/ shut down the lacs * / 

/* ena 11c _exit */ 

/ * only return to tn? calling, not exit */ 
/* -2 for all error case */ 

/* ena lIc_err_return */ 
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